Size: a a a

2019 September 13

СФ

Семён Факторович in technicalwriters
Слово «текстовый редактор», конечно, очень перегружено.

Редактор — это инструмент, в котором мы только редактируем документацию? Или он же занимается и публикацией в разные форматы? А занимается ли он промежуточным представлением (WYSIWYG)? А версионированием и сохранением контента в какую-то систему хранения? А реализацией совместной работы?
источник

NV

Nick Volynkin in technicalwriters
Oleg M
есть еще момент...
когда пишем коллективно - хорош гугл док (документы таблицы) прежде всего из за удобно реализованного режима  коллективной работы...
но когда сдаешь документацию - и Заказчик требует "не мудрите, а сдайте в формате Word" (у некоторых например просто закрыт выход в интернет на определенные ресурсы или вообще закрыт)
сроки горят... а при экспорте в Word сбивается  форматирование . тогда приходит понимание что наверно не надо было изначально "мудрить"... 😖
Вот к тому и мои вопросы.
источник

СФ

Семён Факторович in technicalwriters
может нам какую-нибудь терминологию тут установить?
источник

СФ

Семён Факторович in technicalwriters
типа «редактор» — только то, что редактирует
источник

SP

Sebastian Pereira in technicalwriters
Нет мой вопрос о классическом текстовом редакторе.
источник

OM

Oleg M in technicalwriters
Sebastian Pereira
Нет мой вопрос о классическом текстовом редакторе.
аналог Word . это понятно.
источник

СФ

Семён Факторович in technicalwriters
а если речь идет о других абстракциях (хранение, публикация, промежуточное представление) то это уже «система управление техническим контентом», например — и сюда подойдут Google Docs и Confluence
источник

NV

Nick Volynkin in technicalwriters
Oleg M
есть еще момент...
когда пишем коллективно - хорош гугл док (документы таблицы) прежде всего из за удобно реализованного режима  коллективной работы...
но когда сдаешь документацию - и Заказчик требует "не мудрите, а сдайте в формате Word" (у некоторых например просто закрыт выход в интернет на определенные ресурсы или вообще закрыт)
сроки горят... а при экспорте в Word сбивается  форматирование . тогда приходит понимание что наверно не надо было изначально "мудрить"... 😖
Совсем недавно @ulesko рассказывал, как писать в reST и экспортировать в DOCX и PDF, причем по ГОСТ.
источник

OM

Oleg M in technicalwriters
Nick Volynkin
Совсем недавно @ulesko рассказывал, как писать в reST и экспортировать в DOCX и PDF, причем по ГОСТ.
очень интересно. тут в чате?
источник

СФ

Семён Факторович in technicalwriters
Nick Volynkin
Совсем недавно @ulesko рассказывал, как писать в reST и экспортировать в DOCX и PDF, причем по ГОСТ.
редактором в этом случае у нас был VS Code
источник

NV

Nick Volynkin in technicalwriters
Oleg M
очень интересно. тут в чате?
На митапе Конвеерум в Новосибирске. Может, видео уже доступно.
источник

СФ

Семён Факторович in technicalwriters
но мы писали в RST и вручную, другими инструментами, публиковали его в DOCX, PDF и HTML
источник

КМ

Константин Медведев in technicalwriters
Oleg M
очень интересно. тут в чате?
источник

СФ

Семён Факторович in technicalwriters
Nick Volynkin
На митапе Конвеерум в Новосибирске. Может, видео уже доступно.
источник

ИУ

Илья Улеско in technicalwriters
Nick Volynkin
Совсем недавно @ulesko рассказывал, как писать в reST и экспортировать в DOCX и PDF, причем по ГОСТ.
Не совсем верно, ГОСТа не было в требованиях. Но если нужен ГОСТ для того же подхода, что был рассказан на Конвееруме, подойдёт это: https://gitlab.iaaras.ru/iaaras/gostdown
источник

ИУ

Илья Улеско in technicalwriters
Там же есть пример автоматически сгенерированного документа из шаблона: https://gitlab.iaaras.ru/iaaras/gostdown/-/jobs/5846/artifacts/file/demo-report.pdf
источник

NV

Nick Volynkin in technicalwriters
Эх, ошибся про ГОСТ.
источник

SP

Sebastian Pereira in technicalwriters
И ещё вопрос - есть требование сделать документацию к проекту по ГОСТ 34.201-89 (ТЗ от заказчика уже есть). Какой комплект документов (они не перечислены в ТЗ) будет адекватным?
источник

SP

Sebastian Pereira in technicalwriters
Полный список понятен, он перечислен в ГОСТе, но, насколько я понимаю, стандартная документация для проекта который уже на стадии технического задания может быть меньше.
источник

СФ

Семён Факторович in technicalwriters
Sebastian Pereira
Нет мой вопрос о классическом текстовом редакторе.
отвечая на вопрос — Google Docs бьет всех на порядок
источник