Конкурс Супер-гайд 2018!
У ресурса должна быть нормальная иконка, соответствующая тематике гайда ::mc_351-10:
Подходит, тем более, что что-то другое сложно придумать
Адекватный заголовок и описание ::mc_351-14:
В заголовок лучше добавить больше информации о том, о чем рассказано в гайде, а не только название интерфейсов. Например: "Добавления моделей с помощью того и того", или что-то в этом роде.
Прикрепленный архив со всеми рабочими исходниками гайда ::mc_351-1:
Скачав архив, я не нашел классов, которые описаны в гайде. Нашел только библиотеку. За правилами конкурса, должны быть все исходники в готовом виде. Только загрузить себе в среду и запустить. Нужно исправить.
Минимальный размер гайда: не меньше 3000 символов ::mc_351-10:
Текст гайда не должен быть разрезан и запрятан в спойлеры ::mc_351-10:
Код в гайде должен быть корректно оформлен ::mc_351-14:
Оформление хорошее, но код местами сьезжает, например:
ItemTransformVec3f thirdPerson =
new ItemTransformVec3f(new Vector3f(0f,0,0), new Vector3f(0.005f, 0.15f, 0.04f), new Vector3f(0.55f, 0.55f, 0.55f));
ItemTransformVec3f entity =
Такие моменты надо исправить.
Код в гайде должен быть с поясняющими комментариями ::mc_351-1:
Поясняющие комментарии есть, но так же есть замечания:
- все эти описания методов, которые находятся в начале гайда, можно разместить в виде комментариев в коде. Это значительно сократит гайд и избавит от необходимости каждый раз возвращаться вверх и находить среди кучи информации описание нужного тебе метода, тем более, что описания не такие большие;
- библиотека. В ней не так и много файлов, и думаю надо упомянуть о ней, например: "Создадим некую обертку, для удобства работы с тем то и тем" и, соответственно, описать весь процесс. Для чего это надо? К примеру надо будет внести какие-то коррективы или что-то переделать под себя, а читатель понятия не имеет что и как там устроено.
Если их исправить, то должно быть удобно и смотреться приятнее.
Гайд должен иметь четкую и адекватную структуру ::mc_351-14:
Желательно четко поделить гайд на разделы(я так понял там две части - для айтема и блока, с библиотекой и без). Так же надо добавить описание, что мы будем делать в первой и второй частях(Например: "Создадим блок со своей моделью и т.д."). Убери капс(так как проблема была описана выше), это не красиво смотрится.
Гайд должен быть понятным ::mc_351-14:
В основном все понятно. И это очень хорошо. Но есть один момент - желательно подробнее написать о том, что и где регистрировать, например на какой стадии загрузки мода, или "Далее обычным способом зарегистрируем ModelResourceLocation: " - а где?
Итог
Гайд получился обьемным, много полезной информации. Если исправить все замечания, то, думаю, сможет претендовать на супер гайд и помещение в учебник.