#1839: replace apidocs with something like LXR
-------------------+---------------------
Reporter: dustin | Owner:
Type: task | Status: new
Priority: major | Milestone: ongoing
Version: master | Keywords:
-------------------+---------------------
The apidocs aren't working out very well, for a few reasons:
* they tend to blur the line between public and private APIs
* they do not document instance variables very well
* we have been very inconsistent in writing docstrings
* they're often wrong
* they obscure the actual implementation
I think we'd do better to publish annotate, searchable source code -
something like http://mxr.mozilla.org/.
--
Ticket URL: <http://trac.buildbot.net/ticket/1839>
Buildbot <http://buildbot.net/>
Buildbot: build/test automation
------------------------------------------------------------------------------
Free Software Download: Index, Search & Analyze Logs and other IT data in
Real-Time with Splunk. Collect, index and harness all the fast moving IT data
generated by your applications, servers and devices whether physical, virtual
or in the cloud. Deliver compliance at lower cost and gain new business
insights. http://p.sf.net/sfu/splunk-dev2dev
_______________________________________________
Buildbot-commits mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/buildbot-commits
