))

Каналы про документацию и управление знаниями.

Давно хотел написать этот пост. Кажется, новогодняя ночь неплохо для него подходит. Я уже делал подборку чатов, а теперь напишу про каналы. Это не взаимный постинг — я им принципиально не занимаюсь. Просто перечислю всё, что сам читаю. В порядке возрастания подписчиков, чтобы эффект был равномернее. Если кого-то забыл, завтра проснусь и на свежую голову допишу.

Неожиданно, первым будет не канал, а блог на Дзене.

IT-всячина глазами технического писателя (9 читателей).
Станислав пишет нечасто, но зато там целые истории про работу техписателя.

@getdocument (25).
Автор периодически постит ссылки на хорошие статьи и видео, иногда пишет о собственном опыте обучения, например про документирование API и книгу Docs like Code. (Имя автора знаю, но в канале оно не указано, так что не пишу).

@KnowledgeConfChannel (269). Канал KnowledgeConf — конференции про управление знаниями в IT.

@shut_up_and_write Shut up and write (370).
Мария хорошо пишет про документацию со стороны UX и пользовательских сценариев. В 2019м была серия постов со сравнением документации популярных продуктов сейчас и много лет назад. Особенно полезно, если вы пишете доки для не-разработчиков.

@the_know_all The Know All — Управление знаниями в IT (373).
Лана, с которой мы вместе работаем в ПК KnowledgeConf, ведёт канал про управление знаниями. Мой любимый пост — про Окно Джохари.

@techwriters Techwriter's Daily (390).
Анонимный автор или даже команда авторов внимательно следит за курсами и мероприятиями для техписателей, иногда пишет про инструменты и другие полезные штуки. Аноним, спасибо за репосты!

@technical_writing Technical Writing 101 (718).
Никита пишет про Markdown и генераторы статических сайтов, часто пробует новые инструменты, а ещё находит ссылки на дельные статьи на английском. Мне особенно понравились посты про диаграммы как код и линтер Vale. Ещё Никита — завсегдатай чата @docsascode.

На случай, если это куда-нибудь репостнут, добавлю себя.

@docops, DocOps (1796)
Николай, пишу про документацию как код и другие практики DocOps. Пропагандирую само это слово и всё хорошее, что за ним стоит. Помогаю делать конференцию KnowledgeConf. Поддерживаю техписательское сообщество по мере сил. Раньше организовывал митапы про документацию и в 2020м ещё буду.

Посмотрим на прирост читателей везде

Да, у меня меньше всего читателей. Корона не спадёт (её и так нет). Обычно пишу достаточно колко, обнажая моменты, оторые многие избегают.
Вот на новый год появилась идея на статью по мотивам опять же статьи @SuckMyNuts. Также, есть небольшие идейки по контенту, что давно витали у меня в мозгу, но не вписывались в полноценную статью.
Помимо этого уже давно сформилровалась идея на еще одну статью, очень интересного формата, но я не скажу какого )

Всех с наступающим (наступившим) 2020 годом! Желаю всем творческих успехов, крепкого здоровья и прекрасного настроения! Огромное спасибо участникам за вклад в развитие сообщества.

В украине ещё 22:38

На Украине

Вотевер

Таки "в". По традиции конечно "на", но к черту традицию, если она нас ведёт к конфликтам на пустом месте.

Я спорить не буду, но по нормам русского языка, который используют техписы, правильно "на".

Помпео не исключил изменения планов визита на Украину
=================
Минимальная зарплата в Украине с 1 января повысилась до 4723 грн.

Вот и думай как правильно )

Интересно, почему Аляска не возмущается?..

Вы, конечно, нашли за что зацепиться. :)
Молодцы.

ребят, а подскажите, с чего вообще начать писать документацию? А то всё кажется необъятным, а когда начинаешь описывать какие-то мелкие компоненты, то начинаешь запутываться в деталях :)

Неплохо бы начать с плана.

👍

В сети даже есть готовые шаблоны DP

Documentation Plan