AB
Ребята, привет! А вы могли по порекомендовать литературу по документированию? Меня разработчики спрашивают, а я не знаю, что посоветовать, т.к. немного из другого лагеря :)
Смотря что они документируют. Я всем советую Ильяхова.
Size: a a a
2019 September 12
AB
Но это если разработчики страдают канцеляритом.
AT
Смотря что они документируют. Я всем советую Ильяхова.
Спасибо! Ильяхов в рекомендациях есть, как я поняла, им хочется счего-то более прикладного по тематике.
(Например, я им рекомендовала какие-то части из Зинсера читать, но это было для тех, кто у нас пишет свои статьи о технологиях)
(Например, я им рекомендовала какие-то части из Зинсера читать, но это было для тех, кто у нас пишет свои статьи о технологиях)
AT
Но это если разработчики страдают канцеляритом.
Те, кто не страдает, хотят вылечить тех, кто страдает :)))
АХ
Ребята, привет! А вы могли по порекомендовать литературу по документированию? Меня разработчики спрашивают, а я не знаю, что посоветовать, т.к. немного из другого лагеря :)
а зачем литература? думаю разработчикам более чем достаточно будет примеров хорошей документации) дайте им примеры)
AT
а зачем литература? думаю разработчикам более чем достаточно будет примеров хорошей документации) дайте им примеры)
Дельная мысль.
AT
Хотя книги тоже не помешают для развития (просят же люди)
EN
Ребята, привет! А вы могли по порекомендовать литературу по документированию? Меня разработчики спрашивают, а я не знаю, что посоветовать, т.к. немного из другого лагеря :)
чего они хотят? научиться писать? на русском или английском? или просто больше узнать о документировании?
AB
Те, кто не страдает, хотят вылечить тех, кто страдает :)))
Я одного коллегу-разработчика вдохновила на покупку двух книг Ильяхова. И правда он стал лучше писать, я это прямо сейчас наблюдаю. Но вы правы, те, кто страдает канцеляритом, те не знают что страдают.
AT
чего они хотят? научиться писать? на русском или английском? или просто больше узнать о документировании?
Энтузиасты хотят составить список литературы про документирование (интервьюирование, написание/поддержка). И направлять к нему тех, кто хочет прокачаться в этом направлении знаний, т.е. сделать из этого кусочек матрицы компетенций.
Так что думаю, что подойдёт всё — на английском они читают все, а литература нужна и для начинающих, кому «только глянуть», и для продолжающих, которые хотят в это вкопаться серьезно.
Так что думаю, что подойдёт всё — на английском они читают все, а литература нужна и для начинающих, кому «только глянуть», и для продолжающих, которые хотят в это вкопаться серьезно.
EN
Энтузиасты хотят составить список литературы про документирование (интервьюирование, написание/поддержка). И направлять к нему тех, кто хочет прокачаться в этом направлении знаний, т.е. сделать из этого кусочек матрицы компетенций.
Так что думаю, что подойдёт всё — на английском они читают все, а литература нужна и для начинающих, кому «только глянуть», и для продолжающих, которые хотят в это вкопаться серьезно.
Так что думаю, что подойдёт всё — на английском они читают все, а литература нужна и для начинающих, кому «только глянуть», и для продолжающих, которые хотят в это вкопаться серьезно.
есть https://www.microcopybook.com/, правда она больше про UX writing. Я читаю сейчас The product is docs, она больше про организацию процессов
AT
Е-е-е, спасибо!
YS
Чехова кстати читать надо, он будучи врачем, жуть как бесился по поводу канцелярита (извините за офтоп)
EO
Энтузиасты хотят составить список литературы про документирование (интервьюирование, написание/поддержка). И направлять к нему тех, кто хочет прокачаться в этом направлении знаний, т.е. сделать из этого кусочек матрицы компетенций.
Так что думаю, что подойдёт всё — на английском они читают все, а литература нужна и для начинающих, кому «только глянуть», и для продолжающих, которые хотят в это вкопаться серьезно.
Так что думаю, что подойдёт всё — на английском они читают все, а литература нужна и для начинающих, кому «только глянуть», и для продолжающих, которые хотят в это вкопаться серьезно.
где-то ж ранее в чате кто-то давал ссылку на книжку 101 Tech Writing (или как-то похоже называется). 101 это всегда для начинающих
AT
где-то ж ранее в чате кто-то давал ссылку на книжку 101 Tech Writing (или как-то похоже называется). 101 это всегда для начинающих
Спасибо!
AT
Чехова кстати читать надо, он будучи врачем, жуть как бесился по поводу канцелярита (извините за офтоп)
Не все могут быстро перенести Чехова в практику. Увы.
AT
где-то ж ранее в чате кто-то давал ссылку на книжку 101 Tech Writing (или как-то похоже называется). 101 это всегда для начинающих
Да, я понимаю, что где-то раньше это было, и прошу прощения за повтор вопроса, если он случился. Сложно искать по чату глубоко по истории, а ссылки на книги могут быть прямо под рукой у кого-то.
AV
Да, я понимаю, что где-то раньше это было, и прошу прощения за повтор вопроса, если он случился. Сложно искать по чату глубоко по истории, а ссылки на книги могут быть прямо под рукой у кого-то.
А список книг нельзя закрепить вместе с правилами? Полезная информация. Я себе копирую все (если успеваю заметить).
D
Как вариант, есть смысл ввести хэштег. Но его, боюсь, будут часто забывать