Рецепты

Рецепт — это задача целиком: что понадобится, шаги с полными примерами, что проверить в конце. Не «вот метод», а «вот как сделать».

Написан до конца #

Ждут того, чего ещё нет #

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

Один написанный до конца полезнее пяти начатых.

Как устроен рецепт #

1. Задача — что получится в конце, одной строкой.
2. Работает ли сегодня — сказано прямо, до шагов.
3. Что понадобится — права, ключи, идентификаторы.
4. Шаги — примеры целиком, запускаются копированием.
5. Что проверить — включая то, что обычно забывают.
6. Чего этим не сделать — граница возможностей.