Зачастую при любой разработке возникает необходимость написать код, про который известно заранее что он:
- Крайне не гибок. Или..
- Может вызвать баги, проблемы в дальнейшем. Или..
- Совершенно не читаем.
Или такой код достаётся по наследству, и хочется пометить места, которые надо затем выправить. Такой код называется по-русски костыль. К сожалению на англоязычных сайтах трудно найти информацию об этом, так как у них термин "костыль" - отсутствует в принципе. Рекомендуют переводить, как "kludge" - но это не часто понимают.
Вопрос - как помечать костыли в коде комментариями, чтобы было просто составить список из всех костылей в проекте, и крайне желательно - чтобы была их обозримость в IDE, может даже расстановка приоритетов? Меня больше интересует PhpStorm, но другим будет интересно узнать про их IDE.
P.S.
Есть конечно спец-метка в комментах TODO
, но хотелось бы представлять костыли и TODO
отдельно друг от друга, всё таки они сильно разные по сути. Поэтому некоторые договариваются о специальных комментах вроде:
/* TRASHCODE {why below code is bad} */
...
/* TRASHCODE end*/
Потом по коду выискать просто, но помощи IDE в обозрении костылей в таком случае нет.