Супер-гайд 2018!

CMTV

Основатель
Администратор
1,304
4
601
Всем привет!

Плагин на продвинутые достижения уже установлен и вместе с этим конкурс "Супер-гайд 2018" объявляется открытым!

Все, что нужно сделать — написать гайд.
Дело полезное не только для форума, но и для других создателей модов.

Награды
Каждый создатель супер-гайда получит уникальное достижение "Гайд-мастер" (20 баллов). Но это не повод останавливаться!
За 3 супер-гайда вы получите достижение "Гайд-профи" (30 баллов), а за 5 "Гайд-эксперт" (40 баллов).

В сумме за 5 супер-гайдов можно поднять целую лигу!

super_guide_2018_awards.png

Кроме того, каждый супер-гайд помечается на форуме как "Рекомендуемый".
Он будет высвечиваться в увеличенном масштабе на самом верху.
super_guide_2018_awards_recomended.png

Наконец, ваш гайд будет добавлен в учебник на сайт с указанием авторства.

Примеры супер-гайдов
Старайтесь брать пример стиля изложения со статей в учебнике.
Обязательно ознакомьтесь с тем, как излагают материал победители конкурса за предыдущий год на странице супер-гайдов.

Какую тему выбрать для гайда?
У нас естьсписок необходимых туториалов, которые особенно нужны в учебнике.
Можете спокойно писать на любую из перечисленных там тем.

Критерии
Ваш гайд должен соответствовать ВСЕМ критериям ниже. За каждый критерий ставится оценка.
  • :mc_351-10: Критерию полностью соответствует
  • :mc_351-14: В целом выполнено, но можно сделать лучше
  • :mc_351-1: Критерию не соответствует
Для супер-гайда по всем критериям нужно иметь :mc_351-10: за очень редкими исключениями, которые обсуждаются уже на месте. В любом случае, отметок :mc_351-1: быть не должно.

Список критериев:
  • У ресурса должна быть нормальная иконка, соответствующая тематике гайда
    Одного взгляда на иконку должно быть достаточно для того, чтобы более-менее понять, про что гайд
  • Адекватный заголовок и описание
    По ним пользователь должен понять, про что ваш гайд
  • Прикрепленный архив со всеми рабочими исходниками гайда или ссылка на GitHub репозиторий
    В исключительных ситуациях архив/ссылку на GitHub прикреплять не обязательно. Рабочие исходники — значит любой может их скачать, загрузить в среду, запустить майн и он не скрашится
  • Минимальный размер гайда: не меньше 3000 символов
    При исключительных обстоятельствах, (мега-офигительный, но удивительно короткий гайд) это условие можно не брать в рассмотрение
  • Текст гайда не должен быть разрезан и запрятан в спойлеры
    Это плохо выглядит и неудобно читается. Хотите разделить гайд на несколько разделов? Выделение жирным и размер шрифта вам в помощь
  • Код в гайде должен быть корректно оформлен
    Блоки кода должны быть помечены соответствующими языками. Строчный код (включая ссылки на классы и т.д.) должен оформляться с помощью bb-тега [icode]
  • Код в гайде должен быть с поясняющими комментариями
    Поясняйте логику и поведение, связанные с гайдом и Forge. Не комментируйте то, что относится к языку программирования
  • Гайд должен иметь четкую и адекватную структуру
    Большие гайды нужно разделять на разделы с правильной последовательностью изложения
  • Гайд должен быть понятным
    Чем больше поясняющих и демонстрационных картинок, тем лучше. Есть видео? Еще лучше!
Запрещено пересказывать написанное в учебнике. Но дополнять можно.

Текущие победители:
Ставьте лайки и оставляйте рецензии на понравившееся (или не понравившееся) гайды.

Я буду проверять гайды читабельность и оформление. По части кода и его правильности, я надеюсь, выскажутся опытные участники форума.

А ты уже стал гайд-мастером?
 
Последнее редактирование модератором:

CMTV

Основатель
Администратор
1,304
4
601
Для участия оставьте в этой теме ссылку на свой гайд с комментариями (если есть).
 

CMTV

Основатель
Администратор
1,304
4
601
@Vmani и @SorenLeyxor. Гайды приняты к рассмотрению.

И еще. Не надо писать кол. во символов и писать про то, что вы хотели бы принять. Это и так понятно)
 
3,005
192
592

CMTV

Основатель
Администратор
1,304
4
601
Гайд @Крокодил принят к рассмотрению. Извиняюсь за то, что так долго не проверял гайды. Сегодня время есть — этим и займусь.
 
Последнее редактирование:
2,932
44
598
@CMTV этот конкурс распространяться на переводы? Или для переводов есть какой-то отдельный "конкурс"? Куда надо "его" вписать что бы получить достижение? (Получил ачивку)
И что там с проверкой моего гайда:
 
Последнее редактирование:
1,470
19
189
// Оффтоп: Не баг, а фича
 
Сверху