Search First

---
name: search-first
description: Посмотреть наружу вместо догадки. Вызывать, когда не знаешь, как принято сейчас; не знаешь, есть ли готовое решение; собираешься написать распространённую вещь; помнишь ответ, но из обучения, а не из проверки. Также перед новой записью каталога и перед выбором библиотеки, формата или соглашения.
---

# Сомнение — повод посмотреть наружу

## Когда это обязательно

Не «когда захочется», а по признаку. Четыре признака:

1. **«Как это принято сейчас».** Обучение кончилось в прошлом, мир нет.
2. **«Наверняка уже есть готовое».** Правило «сперва готовое» — не пожелание: своя реализация
   распространённой вещи оплачивается собственной поддержкой навсегда.
3. **«Я это помню».** Помнить и проверить — разные утверждения. Вспомненный API мог быть
   переименован, библиотека — заброшена, соглашение — заменено.
4. **Перед новой записью каталога.** Раздел «готовый аналог» в README записи обязателен, и
   «не искал» — не ответ на него. Это единственная часть правила, за которой следит машина:
   `bash tool/selfcheck/gates.sh`.
5. **Всегда, когда возникло сомнение** — даже если кажется мелочью и даже если владелец рядом.
   Человек чаще всего не знает тоже: он и позвал агента, чтобы не разбираться. Двое, не знающих
   как принято, договариваются до местного костыля — и тот выглядит согласованным решением,
   а не догадкой. У человека спрашивают, чего он хочет; как принято — спрашивают у мира.

## Как искать, чтобы не получить пересказ

- **Ищи код, а не статьи.** Репозиторий, исходник, issue — сильнее блога и сильнее выдачи.
  Разбор конкурентов по документации однажды дал нам три неверных вывода подряд; те же выводы,
  сделанные по их коду, оказались противоположными.
- **Смотри состояние, а не звёзды.** Дата последнего коммита, доля коммитов от бота,
  открытые issue. Мёртвый проект с 88 ⭐ — не решение.
- **Проверь лицензию до того, как взял.** Бывает «MIT, но»: у одного из разобранных нами
  проектов Modified MIT запрещает использовать код как данные для обучения.
- **Спроси, кто заполняет поле.** Прежде чем копировать чужое решение — кто в нём источник
  истины: машина или автор? Поле, заполняемое автором, переносит к нам его дефект вместе с формой.

## Что записать после

- Нашёл готовое и взял — назвать в коде или README, откуда.
- Нашёл готовое и **не** взял — назвать причину. «Не подошло» без причины через месяц читается
  как «не искали», и поиск повторяют.
- Не нашёл — так и сказать. «Не искал» и «нет» — разные утверждения, и второе сильнее.

## Чего не делать

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