Size: a a a

technicalwriters

2021 January 10

V

Vasiliy in technicalwriters
AVDR
Джунский вопрос: чем, кроме ворда, можно оформлять документацию по ГОСТам? Присматриваюсь к латеху, но возможно, есть еще варианты?
В латехе можно нормально оформить документы под ЕСПД и ЕСКД. Совместная работа через гит тоже вполне успешно удается. Словари, картинки тоже поддаются нормальной автоматизации средствами латеха
источник

AY

Andrei Yemelianov in technicalwriters
Александр Мокрушин
Погуглите  gostdown. Набор библиотек, которые из маркдауна с помощью pandoc создают docx по ГОСТу
+++
источник

SR

Stas Rychkov in technicalwriters
Кирилл Кулаков
autodoc ругается на импорты модулей которых нет в папках, задумка собственно как раз не тянуть всю систему за собой. Как можно отключить чтоб autodoc не пробовал import и from... вызывать? А только из имеющихся файлов в брал классы с докстрингами?
Видимо нужны все импортируемые функции. Если нужно исключить некоторые, используйте заглушки (моки).

https://stackoverflow.com/questions/15889621/sphinx-how-to-exclude-imports-in-automodule
источник

M

Maeg in technicalwriters
Eduard Tibet
Проблема с рамками решается просто - это слой выделен на уровень оформления. Когда автор пишет, он не думает о рамках совсем. В этом и состоит принцип разделения содержание и оформления.
Да, у меня в своё время был вордовский шаблон, где рамки были загнаны в колонтитулы. Было терпимо :)
источник

КК

Кирилл Кулаков... in technicalwriters
Благодарю.
источник
2021 January 11

СФ

Семён Факторович... in technicalwriters
источник

СФ

Семён Факторович... in technicalwriters
как вам такое?
источник

F

Fagor in technicalwriters
Норм, предупредили, зачем отказываться, принимай и вперед. Или закрывай. Зачем вам давать достпу к "нет", хоть кто то нет воо ще нажимает? Статистика есть? Меня у JB бесит это окошко, про куки, я зашел туда зная зачем, все едино соглашаюсь.

Или вы о другом?
источник

NV

Nick Volynkin in technicalwriters
Семён Факторович
как вам такое?
Недостаточно канцелярский текст, можно было сказать «для функционирования функционала осуществляется использование технологии Cookies».
источник

F

Fagor in technicalwriters
Может проще - "смирись с использованием печенек или вали отсюда холоп" И кнопка "смириться" или "смиренно принимаю".
источник

NV

Nick Volynkin in technicalwriters
Мне нравится, как это написали на https://www.artlebedev.ru/ )
источник

F

Fagor in technicalwriters
источник

F

Fagor in technicalwriters
JB, они конечно позиционируют себя для разработчиков, стилистика в норме, но текста, по мне излишне. Консолька под рутом рабочая для команды, может даже для команд. Ищут себе например любопытных, rm что ли ввести.
источник

NV

Nick Volynkin in technicalwriters
Точно, и у JB очень хорошо. А текст не лишний, как раз достаточно, чтобы принять информированное решение.
источник

F

Fagor in technicalwriters
Nick Volynkin
Мне нравится, как это написали на https://www.artlebedev.ru/ )
А по мне не оправданное использование выражений с ругательством.
источник

NV

Nick Volynkin in technicalwriters
Fagor
А по мне не оправданное использование выражений с ругательством.
Это вполне в стиле коммуникаций Студии. Вот они такие во всём. 🤷‍♂️
источник

YP

Yana Prosvirova in technicalwriters
В нотификации меня скорее смущает слово "функционал" - функционал и функциональность вещи разные
источник

NV

Nick Volynkin in technicalwriters
Yana Prosvirova
В нотификации меня скорее смущает слово "функционал" - функционал и функциональность вещи разные
Кажется, пора уже принять как факт, что для большинства людей это одно и то же слово.
источник

СФ

Семён Факторович... in technicalwriters
Fagor
Норм, предупредили, зачем отказываться, принимай и вперед. Или закрывай. Зачем вам давать достпу к "нет", хоть кто то нет воо ще нажимает? Статистика есть? Меня у JB бесит это окошко, про куки, я зашел туда зная зачем, все едино соглашаюсь.

Или вы о другом?
«для работы функционала сайта» — очень перегруженая формулировка, на грани с тавтологией

вариант «для работы сайта» ничем не хуже, зато гораздо легче
источник

СФ

Семён Факторович... in technicalwriters
ну и да, функционал/функциональность сильно режет профессиональный глаз:)
источник