Ведете ли вы документацию для проектируемого сайта или приложения?
Доки в отдельном инструменте / сайте / в одном клике от кода = доки никто писать не будет
Доки или в коде или нигде
Если документация относиться не к файлу, а к директории, то казуально пишем ридми.рст прямо в той же директории
Но даже большей описательной силой является багтрекер проекта + его репа
Редмайн с базой знаний в вики