Небольшая заметка о том, как писать заголовки. Главное правило — заголовок не должен делать предположений о читателе или диктовать ему шаги. Читатель — абсолютно нейтральная сторона. Указывать ему — все равно что ломать четвертую стену, то есть фу.

Примеры плохих заголовков:

  • 10 фактов о JavaScript, которые должен знать каждый разработчик. Ничего я тебе не должен, отвали.

  • 20 фактов о Python, которые вы не знали. Я на нем 8 лет писал, все я знаю.

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

  • Посмотрите это видео прямо сейчас или добавьте в закладки. Спасибо, сам разберусь, что и когда смотреть и где хранить.

Удивляет, что вроде бы нормальные ребята нет-нет да озаглавят материал в таком духе. Один кложурист написал статью “Why your REPL experience sucks”. Я посмотрел код, а он там жестко накосячил. Интересно выходит: косячит он, а experience sucks мой.

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

Нельзя тыкать читателю, что он знает и что нет, что и когда смотреть. Читатель сам прекрасно разберется.