Правда ≠ не ложь

Перед списком ленивый писатель пишет:

Чтобы включить гипердрайв, сделайте следующее:

  • перейдите в панель управления,
  • переведите тумблер «Гипердрайв» в положение «Вкл.»,
  • поверните пусковой ключ по часовой стрелке на 90°.

Не ленитесь! Пишите конкретно, что́ следует дальше. «Три шага», «новые модели», «наши клиенты» — всё лучше, чем «следующее».

«Следующее» ничего не значит, но как будто подходит ко всему. Это аморф, как «объект» или «человек».

Программисты любят слово «объект». Если программа сохраняет файлы и папки, программист скажет «программа сохраняет объекты». Это коротко и корректно, ведь и файл, и папка — это объекты.

Писать «следующее» тоже коротко и корректно. Фишка в том, что писать надо не корректно, а информативно.

Корректное не противоречит фактам.

Информативное предъявляет факт.

Хороший писатель не просто не лжёт. Он предъявляет правду.

P.S. Писать по-английски «the following» — такой же унылый формализм.

 
6
Kudos
 
6
Kudos

Now read this

Exploring Karax

I’ve been programming in Python for some ten years, but for the last couple of years Nim has become my new love. In this short post I’m discovering Nim as a frontend language by exploring Karax framework. Note that I’m not a frontend... Continue →