Files
2012-02-21 01:15:00 -05:00

1 line
1.9 KiB
JSON

[{"user_id": 205, "stars": [], "topic_id": 9427, "date_created": 1298849430.863348, "message": "Sphinx's API docs are also a bit of a kludge, so autogenerating epydoc (bleh) might be a big win as well", "group_id": 82, "id": 222424}, {"user_id": 207, "stars": [], "topic_id": 9427, "date_created": 1298850214.983361, "message": "i wonder about some sort of \"coverage\" for documentation", "group_id": 82, "id": 222594}, {"user_id": 205, "stars": [], "topic_id": 9427, "date_created": 1298849411.5548589, "message": "It seems that the \"What is this project about, and where are the important parts\" a hard thing to get right, currently", "group_id": 82, "id": 222420}, {"user_id": 205, "stars": [], "topic_id": 9427, "date_created": 1298849392.874922, "message": "Thinking out loud here. But what can RTD do to help people write better documentation, and help people use the software hosted on the site better?", "group_id": 82, "id": 222416}, {"user_id": 207, "stars": [], "topic_id": 9427, "date_created": 1298850286.628782, "message": "i'm not sure it's really suitable to try though, because a lot of docs don't specifically mention classes and functions in a way that sphinx can recognize", "group_id": 82, "id": 222614}, {"user_id": 207, "stars": [], "topic_id": 9427, "date_created": 1298850249.331692, "message": "not full-on auto-generation, but if it could figure out which classes and functions are documented and which aren't, it could be awesome", "group_id": 82, "id": 222604}, {"user_id": 927, "stars": [], "topic_id": 9427, "date_created": 1299084240.4309139, "message": "I try to provide real prose docs and use autodoc to provide an API reference; this has proven slightly annoying for a project using remoteobjects where I want to show the existence of a field even if it has no documentation but don't want to see repeated copies of the field's documentation - I've been meaning to look into a middle ground between undoc-members and nothing", "group_id": 82, "id": 248562}]