Re:An API is a user interface
by arp242 on Wednesday November 25, 2020 @11:27AM
(#25210909)
I've grown to like unstructured documentation, rather than the more structured headerdoc/doxygen and the like. If you write it well as prose I find it's often clearer. With doxygen it sometimes feel like filling in a bureaucratic form rather than actually writing documentation (and it often reads like it, too).
[ Parent
| on HN ]
Re:An API is a user interface
by ChrisMarshallNY on Wednesday November 25, 2020 @12:16PM
(#25211559)
Completely agree. The headerdoc stuff is just for a reference.