Средства и методы разработки

Доки из доксигена полностью эквиэвалентны комментариям. Пиши как для доксигена, сам доксиген не запускай -- смотри комментарии в редакторе. Я вот о чём. А если комментариев не написал (без доксигена) -- сам дурак. Я тебе о другом. Из доков уровня доксигена всё равно нихрена не понятно как оно в целом работает. Понятно, что есть такие-то функции, они делают то и это, такие аргументы, такие типы данных. А за деревьями леса не видно. Ибо в доксигене негде попросту писать, как В ЦЕЛОМ оно работает, какие там алгоритмы, какие задачи в целом (без функций и типов данных) решаются и т.п. И в комментариях (из которых доксиген и генерируется -- потому он и бесполезен) это никто не пишет. Такие вещи нужно в отдельном файлике писать, желательно с возможностями нарисовать графику и т.п. Удобен, наверное, да чуть ли не ворд (openoffice). Потому, что удобно написать текст с форматированием удобным для чтения и тут же на бумажке зарисовать нужную графику (блок схему, схему автомата, стурктуры данных, схему связей, вроде UML но попроще), сфотографировать телефоном и вставить прямо в файл. Ибо мучаться с UML-редакторами и прочей хренотой никто не будет -- работы на пол-дня, а результат сомнительный.