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:awill...@whitemice.org> GPG D95ED383
Systems Administrator, Python Developer, LPI / NCLA


------------------------------------------------------------------------------
Meet PCI DSS 3.0 Compliance Requirements with EventLog Analyzer
Achieve PCI DSS 3.0 Compliant Status with Out-of-the-box PCI DSS Reports
Are you Audit-Ready for PCI DSS 3.0 Compliance? Download White paper
Comply to PCI DSS 3.0 Requirement 10 and 11.5 with EventLog Analyzer
http://pubads.g.doubleclick.net/gampad/clk?id=154622311&iu=/4140/ostg.clktrk
_______________________________________________
Doxygen-users mailing list
Doxygen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users

Reply via email to