Re: Справочник INSTEAD

Peter wrote:

Мне проще доработать свою документацию, или  написать новую. Поэтому развиваем тему, писать в виде wiki текста или latex? Я все же склоняюсь к wiki.

Однозначно wiki.
Вот как выглядит пдф выгруженный из текущей вики.
http://storage9.static.itmages.ru/i/13/0107/s_1357574406_6861223_89c04dd26d.png

Qui habet aures audiendi, audiat...

Re: Справочник INSTEAD

У меня большой соблазн заиспользовать reStructuredText....

Re: Справочник INSTEAD

Вики конечно, без сомнений. И побольше примеров кода.

Re: Справочник INSTEAD

Peter wrote:

У меня большой соблазн заиспользовать reStructuredText....

Да ReST будет вполне годным, очень много годных примеров, сделанных на базе ReST, и вполне себе прост в разметке, подозреваю, что dokuwiki базируется на нем.

Qui habet aures audiendi, audiat...

Re: Справочник INSTEAD

И еще предлагаю прикрутить на вики >https://www.dokuwiki.org/plugin:dw2pdf

Qui habet aures audiendi, audiat...

Re: Справочник INSTEAD

И еще если уж речь зашла про плагины >https://www.dokuwiki.org/plugin:tag

Qui habet aures audiendi, audiat...

32 (edited by malcolm 2013-01-07 23:41:34)

Re: Справочник INSTEAD

Поддерживаю vvb Актуальная документация ДОЛЖНА поставляться с движком. В полном объеме. В каком виде она будет оформлена - не суть важно.

Re: Справочник INSTEAD

Я за экспорт с вики, без лишнего геморроя, да и сам причесываю там информацию время от времени

Re: Справочник INSTEAD

Итак, я работаю над новой версией документации. Пока она еще не готова, но уже сейчас она гораздо полнее чем та, что была раньше. Вы можете смотреть за ходом работы здесь:

http://instead.syscall.ru/wiki/ru/gamedev/documentation

На данный момент я переписал/дописал главы с 1-й по 20ю. Вы уже можете пользоваться тем, что есть. Хотя я наверное еще буду возвращаться к старым главам по мере написания новых.

Re: Справочник INSTEAD

Я закончил с документацией. Прошу посмотреть: http://instead.syscall.ru/wiki/ru/gamedev/documentation

Понятно, что она не идеальна, но хотелось бы услышать о грубых каких-то вещах, что забыл?

Хотелось бы через неделю выпустить 1.8.3 уже с этой документацией.

Re: Справочник INSTEAD

Супер, но это не значит, что я перестану задавать вопросы в конфе smile.

Re: Справочник INSTEAD

Да, с новой документацией возникает опасность, что спрашивать уже будет не о чем, а поговорить-то хочется smile

Re: Справочник INSTEAD

Варианты в pdf:
http://instead.googlecode.com/svn/trunk … manual.pdf
http://instead.googlecode.com/svn/trunk … odules.pdf

Лучше оформить не получилось, но все-же, лучше чем было. Ореолековскую доку убрал.

Re: Справочник INSTEAD

Да в принципе хорошо оформлено. Это же документация.

Re: Справочник INSTEAD

В module.pdf на семнадцатой странице таблица с функциями спрайтов обрезана по правому краю.

Re: Справочник INSTEAD

Спасибо, гляну.

Re: Справочник INSTEAD

Есть люди могущие и желающие перевести новую док-цию на английский?
С наличием хорошей документации на рус/анг шансы на развитие инстедоигростроения возрастут. smile