Аннотация

Почему аннотации должны быть индексами

Комментарии пишутся для людей. Но когда функций 10 000, машины тоже должны их читать. Если превратить комментарии из повествования в индекс, полное сканирование становится мгновенным поиском.