Я подготовил документацию для Джека и хочу услышать ваше мнение о ней.
Какие важные темы, на ваш взгляд, следовало бы осветить? Какие важные моменты пропущены? Может ли новичок, только что скачавший джек, по этой документации хотя бы немного освоиться в нём, прежде чем начнёт гуглить туториалы по маппингу под конкретные игры?
Написана частично по материалам хаммеровского хелп-файла, частично из головы. Все иллюстрации сделаны на основе последней версии Джека.
Серьёзный минус - документация только на английском языке. К сожалению, пока не нахожу в себе силы сделать перевод на русский язык. Если какой-то альтруист захочет с этим помочь - буду рад, но вероятность этого, как я понимаю, 0.00001%.
Если вам эта документация покажется удобной - можете выкачивать pdf-ку и положить её в папку с джеком, тогда она будет открываться при нажатии F1, как изначально было задумано.
XaeroX
Если это документация пойдет в стим, разве можно будет в примерах документации светить текстуры из HL ? Может перестраховаться и квейковские взять?
XaeroX писал:
Может ли новичок, только что скачавший джек, по этой документации хотя бы немного освоиться в нём, прежде чем начнёт гуглить туториалы по маппингу под конкретные игры?
Вроде да. Хотя, конечно, не хватает раздела про best practices (а то в туториалах насоветуют, да). Но если ты преподносишь документ именно как reference guide, то оно и понятно.
Цитата:
разве можно будет в примерах документации светить текстуры из HL
>Хотя, конечно, не хватает раздела про best practices
Для этого уже нужны карты примеры. Брашворк -- такая штука, что её проще показать чем рассказать.
PunkPaToB писал: разве можно будет в примерах документации светить текстуры из HL
Ты ещё спроси - можно ли в стиме выкладывать скриншоты из HL. И вообще упоминать, что джек с халфой работает.
По копирайтам требование оч.простое - не выкладывать ассеты из халфы. То есть сами текстуры в чистом виде. А тут всего-навсего картинки, к тому же местами отмасштабированные по самое пикачу.
Цитата:
nemyax писал: не хватает раздела про best practices
А как это могло бы выглядеть, применительно к редактору? Мини-туториалы?
XaeroX
То что камеру можно в точные координаты ставить и то что можно сет вертексов скукоживать в точку или скейлить (вообще как то не замечал наличия контекстного меню в вертексмоде).
XaeroX писал:
А как это могло бы выглядеть, применительно к редактору? Мини-туториалы?
Что-то вроде. Не пошаговые процедуры, а общая рекомендация-заголовок и текст, где приводится её обоснование и описывается, какими инструментами редактора она достигается.
Адекватного примера для гжэка привести не могу, сорри =(
Круто!
Отличное описание. Довольно живо описано, с некой аккуратностью и трепетностью автора. Не знаю как передать точно эту манеру, но такого описания не хватает многим документациям. Про него можно сказать user-friendly, наверное. Описание фич в основном на простом техническом английском.
Осилил пока далеко не всё прочитать. Не знаю когда получиться осилить полностью.
Узнал для себя про фичу cordon state.
Большую часть из того что прочитал я уже знаю либо от самого Ксерокса, либо по опыту тестирования.
Пока вроде всё, что могу сказать. Ну и спасибо за документацию
Это, вероятно, фрагменты, взятые из хаммеровского хелпа. Его действительно приятно читать, сразу видно - писал носитель языка, при этом хорошо знающий описываемый софт.
Цитата:
ComradeAndrew писал: Описание фич в основном на простом техническом английском.
А это - уже, вероятно, про мой английский.
Да, до уровня свободного владения мне ещё далеко.
Цитата:
ComradeAndrew писал: Ну и спасибо за документацию
Пожалуйста. Рад, что кому-то она оказалась полезной.
Говоря про живость, я имею ввиду такую манеру описания, когда как бы происходит общение с юзером, а не просто голое описание.
То есть читающий чувствует, что это для него написано и внимательность сразу повышается и понимание соответственно тоже.
Может так понятнее
ComradeAndrew давным давно какой-то мудак решил, что любая документация должна максимально абстрагироваться от живого общения с пользователем, в результате чего подобные документации стало невозможно читать. Соответственно их никто и не читал. Ну разве что инструкцию к атомной электростанции.
Дядя Миша писал:
давным давно какой-то мудак решил
Это не волевое решение могущественного мудака, а обычный человеческий порок. По умолчанию человек, во всяком случае нашенский, срывается в упоротый канцеляризм при малейшей возможности. Созданию документации ведь тоже надобно учиться, как и любой осмысленной деятельности.