Простое и сложное

В пещере живут люди, на стенах пещеры – тени. Один человек смотрит на тени и описывает другим.

Сценарий 1

– Это неравносторонний четырехугольник, иногда бывает пятиугольником или шестиугольником. В пятиугольнике обязательно присутствует Y-образная развилка, причем отношение между верхними ветками находится в функциональной зависимости от самой короткой стороны пятиугольника. По результатам 1000 измерений средняя сумма внутренних углов многоугольников составляет 573 градуса, среднеквадратичное отклонение 15.

Что наблюдаем здесь?

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

Сценарий 2

– Это тень (точечная проекция) проволочного куба. Куб – это призма на квадратном основании, высота равна стороне основания. В декартовых координатах вершины единичного куба: (0, 0, 0), (0, 1, 0), (0, 1, 1), (0, 0, 1), (1, 0, 0), (1, 1, 0), (1, 1, 1), (1, 0, 1).

Наблюдаем:

• догадаться, что это куб, было непросто;
• читается описание легко,
• автору неловко, что занимается такими приземленными вещами;
• читателям кажется, что все и так очевидно.

А какой сценарий выбираешь ты?

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

Поддерживать вещи простыми – это важно!