Re: [Doxygen-users] are document generators dead?

[Adam T. W. <awi...@wh...>]

On Mon, 2014-10-06 at 22:03 -0700, Tom Johnson wrote: 
> Are document generators for APIs dead? When I look over the possible
> options out there, everything seems built about 10 years ago. I don't
> see anything new coming out of this genre of tools. I find this odd,
> given that APIs themselves are exploding in popularity.

Nothing new is required; this is a solved problem.  Solved about 10
years ago.

> I'm guessing that most new APIs today are REST APIs, and none of the
> current document generators really address REST?

???  REST APIs are 'theoretically' self-documenting.  Which is total BS,
but the trope REST fanboys hide behind.  Underlying any REST API is code
- an API written in source code - that needs to be documented.  And that
can be accomplished with the same tools. 
> Can someone clue me in as to why there aren't more recently developed
> tools? Doxygen seems to be the best of them, but even Doxygen seems a
> bit dated to me. 

Why is it "dated"?  Something that works is not obsolete.

-- 
Adam Tauno Williams <mailto:awi...@wh...> GPG D95ED383
Systems Administrator, Python Developer, LPI / NCLA