В чём писать документацию?
непонятно правда, как быть с ОЧЕНЬ БОЛЬШИМИ начальниками, которые своим долгом считают поправить какую-нибудь запятую в [вордовском] техническом документе и чтобы их правки были приняты.ну вордовским диффом сверять с тем, что было отправлено, и вносить в оригинал (с правильной вёрсткой)
latex?
Confluence Wiki
+ http://marketplace.atlassian.com/plugins/com.k15t.scroll.sc...
+ http://marketplace.atlassian.com/plugins/com.k15t.scroll.sc...
+ http://marketplace.atlassian.com/plugins/com.k15t.scroll.sc...
по Git — что именно нужно?
http://marketplace.atlassian.com/plugins/nl.avisi.confluenc...
но чтобы соответствовало ЕСПД придётся повозиться с шаблонами для экспорта.
+ http://marketplace.atlassian.com/plugins/com.k15t.scroll.sc...
+ http://marketplace.atlassian.com/plugins/com.k15t.scroll.sc...
+ http://marketplace.atlassian.com/plugins/com.k15t.scroll.sc...
по Git — что именно нужно?
http://marketplace.atlassian.com/plugins/nl.avisi.confluenc...
но чтобы соответствовало ЕСПД придётся повозиться с шаблонами для экспорта.
кстати, да - атлассиан уже используется - жира там, конфлюэнс вот этот..
напрягает только что если мне надо что-то в консерватории подправить - я не могу этого сделать. вон в Trac хотя бы править все исходники можно, там довольно просто всё.
git - понятно для чего, для совместной разработки. чтобы программисты своё писали, а технические писатели за ними подправляли
напрягает только что если мне надо что-то в консерватории подправить - я не могу этого сделать. вон в Trac хотя бы править все исходники можно, там довольно просто всё.
git - понятно для чего, для совместной разработки. чтобы программисты своё писали, а технические писатели за ними подправляли
только что если мне надо что-то в консерватории подправитьты можешь написать add-on
Наверное, мне хочется что-то типа markdown с возможностью генерить из него ворд/пдф плюс онлайн-версию документации плюс chm или какие-нибудь более лучшие хелпы под винду.А markup не подойдет? Ебашь html.
Ну или напиши скрипт™.
markupЯ так и делаю
:-)Вот это, например. Хотя как у него с вендою не знаю.
Я тут недавно заценил такую штуку: http://www.methods.co.nz/asciidoc/
Из неё можно собирать chunked, docbook, dvi, epub, htmlhelp, manpage, pdf (default ps, tex, text, xhtml, LaTeX.
PDF после этого ты легко можешь преобразовать в docx, если есть желание (но нафига?..).
Пример:
Они его ещё и через сайт отдают.
Из неё можно собирать chunked, docbook, dvi, epub, htmlhelp, manpage, pdf (default ps, tex, text, xhtml, LaTeX.
PDF после этого ты легко можешь преобразовать в docx, если есть желание (но нафига?..).
Пример:
Они его ещё и через сайт отдают.
похоже, то что нужно! суперб
Я тут недавно заценил такую штуку: http://www.methods.co.nz/asciidoc/Лучший язык разметки, который я видел. Логичный и полный.
А, забыл ещё сказать - его гитхаб умеет показывать.
Пиши в doxygen, в смысле в комментах для него и специальных хпп файлах состоящих только из комментов, для всяких интересных хау-ту, из этого получается хтмл который ты наверное (но зачем?) можешь превратить в вордовский документ.
Главный бонус — что источник плейнтекстовый и да, можно смотреть диффы.
Главный бонус — что источник плейнтекстовый и да, можно смотреть диффы.
Оставить комментарий
yolki
в конечном счёте хотелось бы получить вордовский документ.С разметкой, соответствующей ЕСПД.
и при этом чтобы была возможность использовать системы контроля версий - в первую очередь git.
не, можно наверное напрямую в TFS в ворде писать, но чё-то меня это не заряжает оптимизмом.
Наверное, мне хочется что-то типа markdown с возможностью генерить из него ворд/пдф плюс онлайн-версию документации плюс chm или какие-нибудь более лучшие хелпы под винду.
непонятно правда, как быть с ОЧЕНЬ БОЛЬШИМИ начальниками, которые своим долгом считают поправить какую-нибудь запятую в [вордовском] техническом документе и чтобы их правки были приняты.