lightweight markup language

[Mayor]

В чем пробовали вести документацию по проекту?

Интересует:

- этап концепта, еще до перевода в uml

- возможность прикрепить к тексту скетчи

- возможность загнать в svn

- возможность конвертнуть в html, pdf

[Вад]

А что ты пишешь на этапе концепта, ещё до перевода в UML?
Скажем, у меня это разного рода списки - требования, use cases. Сильно реже - mind-map-ы, отображающие pro и contra в случае нескольких альтернативных вариантов. Поэтому проще всё это агрегировать в WinWord- или OpenOffice-документ. Особенно если ещё и картинки нужно повставлять.

[Mayor]

game conceps:

- overview

- game focus

- key design feature

скажем так, пишу не я, а дизайнер - я потихоньку делаю feature cut,

с одной стороны должно быть понятно: кто, когда, почему сделал изменения; с другой в любой момент вернуть фишку, если появилась техническая возможность или показать pdf\html потенциальному артисту

winword\OO мне чем не нравятся - их не отследить в svn, поэтому хотелось бы простой текстовый и одновременно презентабельный формат

[Вад]

TeX?

[RXL]

Или HTML.

TeX мощный, но сложный. Есть ли WYSIWYG редактор, который может работать с TeX напрямую?

Еще одна альтернатива: RTF - он вполне текстовый, что для diff хорошо.
http://ru.wikipedia.org/wiki/Rich_Text_Format

[Mayor]

Один из позапрошлых гейм дизайнеров попробовал html, правда, без wysiwyg - очень не понравилось (возни много), да и большинство ГД верстать в html не умеют.

В принципе, к формату lwml  не ставится задачи наличия, wysiwyg редактора, лишь бы он был прост в изучении.

P.S. наверное, попробую почитать rtf & tex и еще какой-то ансидок формат на примете.

[Антон (LogRus)]

В Wiki довольно удобной вести документацию, есть даже плагины специальные под ведение проектной документации (правда платные)

[RXL]

LogRus, но ведь Вики и SVN не коррелируются...

[Антон (LogRus)]

RXL, встречный вопрос а зачем документацию держать в SVN? Шучу, прощелкал этот момент в требованиях Mayor


Mayor, XML отличный формат, придумайте себе теги и вперёд, самое главное можно взять XSL шаблон, прогнать через него ваши доки и получить, что-то иное

личный опыт такой:
есть xml
первые 2 строки:

Код:

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<?xml-stylesheet type="text/xsl" href="rep3.xsl"?>

Обрати внимание на вторую строчку, двойной клик на файле, он открывается в браузере (на винде по умолчанию) и благодаря второй строчке отображается в удобном виде.

довольно удобно, в качестве редактора XML/XSL использую Notepad++

[RXL]

LogRus, полагаю, тоже для версионности и контроля изменений.

[Антон (LogRus)]

В вики есть версионность и возможность посмотреть изменения.

[RXL]

Но в отрыве от проекта и требуется веб. А SVN еще легко забекапить и забыть, а когда надо - поднять.