*хруст пальцами*

Ну штош, приступим.

📃 Сегодня у нас небольшая подборочка накопившегося.

💥 1. Неплохой гайд под названием “The Insider’s Guide to Becoming a (Contract) Technical Writer” от автора (вроде как) хорошего курса для техписов becometechnicalwriter.com. В гайде автор проходится по всей базе того, что необходимо для контрактной работы техписателем. Гайд больше для жителей US, но большáя часть информации довольно общая, поэтому можно взглянуть одним глазком. Про всё, начиная с резюме, заканчивая наставлениями как не унывать, когда тебя морозят или пытаются нагрузить куда более большим объемом работы, чем было обговоренно зараннее.

🔗 Читать: “The Insider’s Guide to Becoming a (Contract) Technical Writer”

💥 2. Небольшой очерк на извечную тему “почему все так плохо с документацией и что с этим делать” под названием “Software makers have gotten worse at documentation and here's why that's a problem”. Никаких откровений после прочтения не будет, но напомнить себе о нашей с вами полезности лишним не будет.

🔗 Читать: “Software makers have gotten worse at documentation and here's why that's a problem”

💥 3. Заметка “Why programmers don’t write documentation” на очевидную тему но с парочкой довольно годных пойнтов (кроме того, что как бы ну.. должны писать доку мы, а не девелоперы). Заметка была ответом на совсем уж дурацкую статью “This Is Why Most Software Engineers Don’t Write Documentation”, где основным пойнтом было то, что мол нет годных тулз для документирования 🤷

🔗 Читать:“Why programmers don’t write documentation”

💥 4. Гигантский наброс от ко-фаундера и организатора Write The Docs под провокационным названием “Documentation Considered Harmful”. Весь пост проходит под слоганом “documentation may in fact be more harmful than it is helpful”. Ругается на сложность языков и оверусложненные продукты. Самый интересный материал из подборки.

🔗 Читать: “Documentation Considered Harmful”.

#career #en #article