Anatoly Levenchuk (ailev) wrote,
Anatoly Levenchuk
ailev

Category:

"FooBar -- это очень просто"

Я вот подумал на тему трудностей, которые испытывает типовой программист, пишущий документацию к очередному своему нетленному творению. Обычно он не знает, с чего начать и чем закончить -- и о чем вообще писать. Ему все ясно, поэтому писать и не о чем. И сидят часами программисты за нелюбимой техрайтерской работой.

Тогда я подумал про некогда очень популярный способ доносить информацию в форме диалога -- ведь повествование предполагает собеседника. А если эти диалоги списывать из жизни? Трудно писать для абстрактной аудитории, но много легче -- для конкретной. Недаром кроме диалогов Платона или популярнейших некогда книжек "Электроника -- это очень просто!" вспоминается способ писать книжки по материалам курса лекций или цикла семинаров.

Сейчас практически у каждого на десктопе висит аська или какой-нибудь аськозаменитель. Редактор (а как назовем того человека, который изображает из себя "абстрактного читателя"?) спрашивает, автор отвечает. Да, транскрипт такой писательской сессии не будет похож на диалог Сократа и Софиста, но будет намного лучше качеством, нежели текст, не написанный вовсе.

Кстати, не замечали ли вы, что читать FAQи зачастую интереснее, нежели статьи? Вечно молодой жанр диалога...
Subscribe

  • Цены на наши онлайн-курсы в 2021

    Заканчивается зима, прошёл уже год с момента запуска первого нашего курса, и заодно заканчивается год карантинной жути (тьфу-тьфу-тьфу). Поэтому мы…

  • Вычислительное мышление: пять тем для отслеживания в 2021

    Некоторые темы для отслеживания и размышлений на досуге. При этом охотно верю, что у кого-то это идеи для размышления в рабочее время. Вот кто сидит…

  • lytdybr

    Удивляюсь, почему не обсуждаются причины, а только следствия типа "а чего они законы нарушают": не обсуждаются право народа на собрания (с чего это…

  • Post a new comment

    Error

    Anonymous comments are disabled in this journal

    default userpic

    Your reply will be screened

  • 12 comments

  • Цены на наши онлайн-курсы в 2021

    Заканчивается зима, прошёл уже год с момента запуска первого нашего курса, и заодно заканчивается год карантинной жути (тьфу-тьфу-тьфу). Поэтому мы…

  • Вычислительное мышление: пять тем для отслеживания в 2021

    Некоторые темы для отслеживания и размышлений на досуге. При этом охотно верю, что у кого-то это идеи для размышления в рабочее время. Вот кто сидит…

  • lytdybr

    Удивляюсь, почему не обсуждаются причины, а только следствия типа "а чего они законы нарушают": не обсуждаются право народа на собрания (с чего это…