convore.json/groups/python/what-do-you-use-for-generating-api-documentation/messages.json

[{"user_id": 18539, "stars": [], "topic_id": 15246, "date_created": 1301057179.0265231, "message": "sphinx' autodoc features? epydoc seems dead (again). Ordinarily I'd use pydoctor, but I want programmatically generated __all__s :-(", "group_id": 292, "id": 437992}, {"user_id": 24439, "stars": [], "topic_id": 15246, "date_created": 1301057589.359679, "message": "@lvh you could teach pydoctor to parse your @exposed decorator", "group_id": 292, "id": 438040}, {"user_id": 1944, "stars": [], "topic_id": 15246, "date_created": 1301057735.6577139, "message": "Sphinx, any day.", "group_id": 292, "id": 438061}, {"user_id": 886, "stars": [], "topic_id": 15246, "date_created": 1301059721.6239979, "message": "What makes sense depends on how you use docstrings.  If they're canonical & complete, you'll use a different tool than if they're brief hints.", "group_id": 292, "id": 438249}, {"user_id": 886, "stars": [], "topic_id": 15246, "date_created": 1301059783.8943419, "message": "(I'm in the docstrings-as-hints camp myself.)", "group_id": 292, "id": 438258}, {"user_id": 886, "stars": [], "topic_id": 15246, "date_created": 1301060246.929353, "message": "Docstrings are good reminders, but not the place for reference material.  Good docs contain too much that isn't organized by API names anyway.", "group_id": 292, "id": 438324}, {"user_id": 24439, "stars": [], "topic_id": 15246, "date_created": 1301060016.313586, "message": "I read docstrings by opening the relevant source file in my editor :)", "group_id": 292, "id": 438297}, {"user_id": 886, "stars": [], "topic_id": 15246, "date_created": 1301060189.88903, "message": "That's certainly my preferred approach as well.", "group_id": 292, "id": 438319}, {"user_id": 6415, "stars": [], "topic_id": 15246, "date_created": 1301062161.8944609, "message": "Reading docstrings from ipython with ? is my favorite ipython powertool", "group_id": 292, "id": 438590}, {"user_id": 2313, "stars": [], "topic_id": 15246, "date_created": 1301064633.129034, "message": "I use sphinx' autodoc features because I don't want the API documentation entirely separate from everything else. However my API documentation tends to be very detailed including usage examples etc.", "group_id": 292, "id": 438974}, {"user_id": 10377, "stars": [], "topic_id": 15246, "date_created": 1301068592.3444531, "message": "dtx files, using pdflatex", "group_id": 292, "id": 439606}, {"user_id": 1992, "stars": [], "topic_id": 15246, "date_created": 1301077451.5497639, "message": "does anyone use the python port of Docco?", "group_id": 292, "id": 440962}, {"user_id": 1992, "stars": [], "topic_id": 15246, "date_created": 1301077471.795341, "message": "I've used Javascript documentation done in Docco, and it was pretty amazing", "group_id": 292, "id": 440965}, {"user_id": 776, "stars": [], "topic_id": 15246, "date_created": 1301077872.4914589, "message": "full source at: https://github.com/fitzgen/pycco", "group_id": 292, "id": 441034}, {"user_id": 776, "stars": [], "topic_id": 15246, "date_created": 1301077827.390615, "message": "yeah ive used it (pycco) for a couple small scripts and it works very well", "group_id": 292, "id": 441027}, {"user_id": 776, "stars": [], "topic_id": 15246, "date_created": 1301077847.098208, "message": "http://fitzgen.github.com/pycco/", "group_id": 292, "id": 441030}, {"user_id": 20326, "stars": [], "topic_id": 15246, "date_created": 1301085742.2709579, "message": "I use Sphinx\u2014autodoc most of the time, manual API docs when I can afford it. Sphinx is probably one of the better pieces of software I use.", "group_id": 292, "id": 442359}, {"user_id": 776, "stars": [], "topic_id": 15246, "date_created": 1301097347.2411129, "message": "i agree. though it can be used multiple ways since it is all manually written", "group_id": 292, "id": 443436}, {"user_id": 18539, "stars": [], "topic_id": 15246, "date_created": 1301097154.0446861, "message": "pycco looks interesting, but it's really for walking people through code -- not quite API docs", "group_id": 292, "id": 443400}, {"user_id": 1398, "stars": [], "topic_id": 15246, "date_created": 1301146329.5165911, "message": "Sphinx with autodocs so I can use Read the Docs and have http://readthedocs.org/docs/packaginator/en/latest/reference.html", "group_id": 292, "id": 446104}]