Size: a a a

2019 June 24

JM

Jaroslaw Martinow in technicalwriters
Оооо!! Мне этого очень не хватало!!
источник

JM

Jaroslaw Martinow in technicalwriters
Александр Парень
В международном сообществе Write The Docs в Slack есть тема "doctools", где участники делятся различными ссылкам по инструментарию.

Сделал небольшой дайджест:

https://stepshot.net/ - Создаие динамической документации

http://www.picklesdoc.com/ - Делает из Markdown удобоваримый вид

https://pdfshift.io/#features - HTML в PDF

https://dev.to/kefranabg/generate-beautiful-readme-in-10-seconds-38i2 - Попытка создать ReadMe-генератор

https://easydita.com/ - Онлайн редактор DITA

https://www.wappalyzer.com/ - Узнать какие технологии использует сайт

https://stripe.com/docs/api - пример документации

https://www.twilio.com/docs/ -пример документации
Мартынов запомнил это.
источник

NV

Nick Volynkin in technicalwriters
Jaroslaw Martinow
Оооо!! Мне этого очень не хватало!!
Рад, что вам пригодилось. ))
источник

NV

Nick Volynkin in technicalwriters
Я ещё знаю кучу чатов техписательских ))
источник

АХ

Алексей Хорьков in technicalwriters
Nick Volynkin
Я ещё знаю кучу чатов техписательских ))
Может наоборот, не плодить чаты, а схлопнуть в один большой?)) Или как вариант один чат и несколько каналов)
источник

НН

Нац Нац in technicalwriters
А можно к разным каналам подключать одни и те же чаты?
источник

OI

Olga Ilchukova in technicalwriters
Алексей Хорьков
Может наоборот, не плодить чаты, а схлопнуть в один большой?)) Или как вариант один чат и несколько каналов)
Я думаю, что тут принцип бритвы Оккама не подойдёт. Меня устраивает, что в разных чатах я могу поговорить о разном. К тому же, из-за монополизма может пострадать общение с забаненным, но хорошими людьми
источник

NV

Nick Volynkin in technicalwriters
Алексей Хорьков
Может наоборот, не плодить чаты, а схлопнуть в один большой?)) Или как вариант один чат и несколько каналов)
По куче причин не выйдет. Есть чаты конференций, есть чаты каналов, есть чаты сообществ.
источник

АХ

Алексей Хорьков in technicalwriters
источник

АХ

Алексей Хорьков in technicalwriters
Ладно ладно)) я просто предложил))
источник

AP

Alexandr Pereverzev in technicalwriters
сколько народу добавляется сразу оО
источник

НН

Нац Нац in technicalwriters
Ага, у меня канал до 500 почти дорос аж
источник

A

Anastasia in technicalwriters
Anastasia
Коллеги, привет!

А поделитесь, пожалуйста, опытом, как в ваших компаниях проходит согласование новых терминов и именования новых сущностей? Интересует:

- кто и на каком этапе разработки выдвигает варианты именования;
- кто входит в группу согласующих;
- на ком обкатываете на предмет понятности/непонятности;
- боль переименования введённых названий/терминов.

Помимо глоссария, ещё какой-нибудь словарь внутренних терминов ведёте? Если да, по какому принципу разделяете: это в глоссарий, а это в наш словарь-справочник?
Есть в чате общительные техписы из Лаборатории Касперского?
В докладе с ТехДок 2013 упоминается роль "менеджер по терминологии".  Хотелось бы подробности узнать.

https://www.youtube.com/watch?time_continue=1703&v=zKULw-1jnnQ
источник
2019 June 25

СФ

Семён Факторович in technicalwriters
Как сделать так, чтобы документация не болела?

Мы с Семёном @factorized провели сегодня митап про документацию на Highload++ Siberia. Поговорили о типичных проблемах разработки, которые можно решать с помощью документации. Конечно, всё законспектировали. Вот, держите: https://github.com/docops-hq/conf/blob/master/highload/19/siberia/docs.md

Если вы были на митапе или вам просто интересна эта тема — давайте общаться дальше, заходите в чат @docsascode.
источник

СФ

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

СФ

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

NV

Nick Volynkin in technicalwriters
Закинул знакомому из Каспера, он обещал позвать спикеров в этот чат. )
источник

A

Anastasia in technicalwriters
Nick Volynkin
Закинул знакомому из Каспера, он обещал позвать спикеров в этот чат. )
Спасибо!
источник

MD

Mazin Den in technicalwriters
Коллеги, подскажите как правильно: дашборд или дэшборд?
источник

НН

Нац Нац in technicalwriters
Даш
источник