в целом решает задачу. Если хочется что-то посвежее, то можно Doxygen + Sphinx + ReadTheDocs + Breathe. На выходе — красиво. Правда конкретных гайдов не подскажу, но думаю гуглится.
А воообще злободневная тема. У Rust красивые доки, и просто генерить. Не хвататет чего-то такого для плюсов. С набором выше, что я предложил, можно добиться красоты, но в целом значительно менее удобно выходит.
что в очередной раз доказывает, какой ЯП следует использовать в 2020
У Rust худшие в мире доки
Обсуждают сегодня