Глава 21. Зарезервированные слова для описания gotchas

• :TODO:

  Означает, что здесь нужна доработка, простое напоминание.

• :BUG: [id]

  Означает, что здесь находится Выявленная ошибка, дайте описание и (не обязательно) номер ошибки.

• :KLUDGE:

  Если то, что вы сделали, уродливо выглядит и работает, отметьте этот факт и объясните, как вы поступите в следующий раз, если у вас будет время.

• :TRICKY:

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

• :WARNING:

  Предупреждение о чём-либо.

• :PARSER:

  Иногда вам приходится что-то делать для успешного парсинга. Задокументируйте этот факт. Возможно, со временем проблема исчезнет.

• :ATTRIBUTE:

  Общий вид представления атрибута в комментарии. Вы можете создать свои атрибуты, и они тоже будут извлечены роботом.