01 / Наблюдение

Что значит писать точно

Слова «всегда», «лучший» и «полностью защищён» требуют доказательств, которые редко есть у короткой заметки. Если подход помогает в определённой ситуации, полезнее назвать эту ситуацию и ограничения. Сдержанный текст не должен прятать сомнения за формальными фразами.

02 / Подход

Пример аккуратной формулировки

Вместо «статический сайт невозможно взломать» корректнее сказать, что отсутствие серверного приложения сокращает число потенциальных точек атаки, но ошибки веб-сервера и управления файлами остаются возможными. Такой язык не обесценивает совет — он делает его применимым.

Пример

Хорошая техническая статья сообщает, что проверено, а что только ожидается.

03 / Практика

Три пункта для проверки

  1. Отмечайте условия применимости рекомендаций.
  2. Убирайте абсолютные обещания.
  3. Разделяйте наблюдения и выводы.