О чем и как писать программисту в своем блоге?

Блог программиста скорее всего будет связан с знаниями о каких-либо языках и технологиях, способах их применения, опыта практического применения и решения проблем на пути.

В общем и целом, каждая запись скорее всего будет отождествлять собой что-то из списка:

  • решение задачи
  • обзор технологии
  • отзыв о практическом применении
  • пути и способы решения какой либо проблемы.

Чтобы понять ценность записи, зададим себе несколько вопросов:

  • Другие люди могут столкнуться с такой же задачей?
  • Какими знаниями необходимо обладать, для выполнения этой задачи?
  • Обладаю ли я достаточными знаниями для ее выполнения?
  • Смогут ли люди, прочитавшие этот материал, повторить его на практике?
  • Будет ли материал самостоятельным, или это будет некая вырезка из контекста?

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

Допустим вы поняли, о чем будете писать. Настало время классифицировать вашу запись, чтобы любой входящий без беготни по тексту понял о чем речь и надо ли ему это вообще читать.
Заголовок здесь конечно не мало важен, он должен содержать в себе суть получаемого результата от прочтения материала. В данном случае заголовок "О чем и как писать программисту в своем блоге?" должен помочь понять человеку, о чем собственно ему писать и как писать. Здесь заданы две темы, о чем и как. Значит мне надо привести примеры о том, о чем можно было бы написать, и как выстроить возможную структуру материала. Если я начну рассуждать о том, как себя мотивировать или как продвинуть это в поиске, я уйду от темы и забью человеку голову лишней информацией, которую он просто не ожидал тут увидеть. Так что-либо сразу включаем в заголовок все темы материала, либо оставляем это для тем других материалов, отложив свои мысли об этом на потом.

Говоря о структуре материала, хотелось бы обозначить основные части:

Охват тематик

  • Какая сфера применения? (Базы данных, мобильные приложения, веб сайты, копирайтинг и т.д.)
  • Какой вид деятельности? (Изучение, Разработка, Разбор, Коммуникация, Документирование и т.д.)
  • Какие языки программирования? (Если имеет отношение к конкретным языкам программирования либо разметки)
  • Какая ОС? (Если имеет отношения к конкретной ОС)

Введение
Краткое описание проблемы, откуда она появилась и решения которые хотелось бы увидеть или цели для достижения.

Поиски решения
Здесь можно описать этапы достижения целей задачи. О том с чего начали, о чем попутно узнавали, как менялись видимые цели и что мешало.

Результат
Что по итогу стало концом поисков, что было достигнуто и как это решило проблему.

Вывод
Остаток эмоций который остался после решения задачи, что могло изначально помочь, как можно было изначально избежать проблемы и т.д. Все что хотелось бы высказать по данной теме.

Список материалов
Инструменты, сайты, люди, ОС и все что было использовано для выполнения задачи. Желательно именно те версии, которые использовались, если это программные продукты.

По моему мнению, подобные материалы будут максимально полезны для аудитории программистов, которые в данный момент столкнулись с той же задачей либо проблемой, а работа над систематизацией в материал своих действий, поможет отбрасывать лишнее и лучше понимать, что собственно было в итоге сделано.

Этот материал не реализует в полной мере предложенной структуры, так как структура придумывалась в процессе его написания, так что только после того, как у нас в голове появилось описание этой структуры и у меня в том числе как автора этого материала, мы можем начать ей пользоваться, ссылаясь на этот материал в зависимостях =)

Главный совет - никогда не отчаивайтесь, решение всегда существует, просто возможно, вам придется его изобрести.