News for hackers. Stuff that matters.
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).
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.