Size: a a a

DocOps-сообщество

2020 December 21

H

Hartmann in DocOps-сообщество
Ivan Cheban
Хочется в таком виде дерево
У меня плагин для zshell так умеет.
источник

IC

Ivan Cheban in DocOps-сообщество
Это линукс?
источник

H

Hartmann in DocOps-сообщество
Ща, сек.
источник

FM

Fox Mulder in DocOps-сообщество
источник

FM

Fox Mulder in DocOps-сообщество
У меня в закладках были, но я ими не пользовался
источник

H

Hartmann in DocOps-сообщество
Ivan Cheban
Это линукс?
источник

H

Hartmann in DocOps-сообщество
источник

H

Hartmann in DocOps-сообщество
Позволяет отображать вот такое дерево.
источник

H

Hartmann in DocOps-сообщество
Инструкция под др ОС. https://gist.github.com/derhuerst/12a1558a4b408b3b2b6e
источник

IC

Ivan Cheban in DocOps-сообщество
Спасибо!
источник
2020 December 22

VS

Vadim Smelyanskiy in DocOps-сообщество
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
В pandoc завезли Source Mapping для маркдауна!
https://github.com/jgm/pandoc/releases/tag/2.11.3

Осталось придумать, как это дотащить до инструментов, вроде MkDocs, и можно будет делать комменты на собранном сайте со связью к исходнику)
источник

NV

Nick Volynkin in DocOps-сообщество
Vadim Smelyanskiy
В pandoc завезли Source Mapping для маркдауна!
https://github.com/jgm/pandoc/releases/tag/2.11.3

Осталось придумать, как это дотащить до инструментов, вроде MkDocs, и можно будет делать комменты на собранном сайте со связью к исходнику)
Шикарно. Хотя исходник получается сильно перегруженный
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Nick Volynkin
Шикарно. Хотя исходник получается сильно перегруженный
Есть такое

Возможно, на уровне инструментария стоит выносить эту метаинформацию в ещё один отдельный sourcemap, который бы сопоставлял HTML с метаданными и HTML без них, чтобы вес страницы не увеличивать и инфа об исходнике не утекала
источник
2020 December 23

A

Arayomi 🇷🇺🐍 in DocOps-сообщество
Привет всем. Есть у кого-то примеры матрицы компетенций для технического писателя?
источник

NV

Nick Volynkin in DocOps-сообщество
Arayomi 🇷🇺🐍
Привет всем. Есть у кого-то примеры матрицы компетенций для технического писателя?
Встречный вопрос: а у вас сколько писателей в компании?
источник

A

Arayomi 🇷🇺🐍 in DocOps-сообщество
Пока меня одного вроде хватает) Просто скорее всего мне придётся вместе с CEO делать эту матрицу для себя и хочу примеры посмотреть.
источник

H

Hartmann in DocOps-сообщество
Arayomi 🇷🇺🐍
Пока меня одного вроде хватает) Просто скорее всего мне придётся вместе с CEO делать эту матрицу для себя и хочу примеры посмотреть.
У Киты из 101 был пост на эту тему.
источник

H

Hartmann in DocOps-сообщество
Хороший пост-пища-для-размышлений на idratherbewriting.

>Почему технических писателей часто считают столь неважной частью компании?

И еще бонусный пост из комментариев (их тоже почитайте, там хорошо). О грамотном наборе компетенций для современного писателя и о том, почему "технический писатель" не самое удачное название профессии. Он предлагает "complexity translator".

Понравилось оттуда:

>Technical writing could be compared to documenting all the components of a car’s engine. You’ll write down their names and how some parts are connected to other parts. That does not mean you’re qualified to get under the hood of the car and assemble an engine with those parts. But you could work with a technical person to translate their instructions into useable directions.

P.S:
Постить статьи с idratherbewriting слегка моветон, но как показывает практика, далеко не все смотрят по сторонам и вообще что-то читают по теме. Следовательно (в)опрос, вы как, сами почитаете или вам сюда иногда набрасывать интересного?
источник