convore.json/groups/codeconf/documentation-isnt-optional-jacob-kaplan-moss/messages.json

[{"user_id": 28456, "stars": [], "topic_id": 18297, "date_created": 1302386304.462091, "message": "I think that wikis are still useful. Pragmatic much, but inline documentation makes more sense IMO.", "group_id": 4804, "id": 605819}, {"user_id": 28419, "stars": [], "topic_id": 18297, "date_created": 1302386161.5714581, "message": "I don't agre....", "group_id": 4804, "id": 605812}, {"user_id": 28370, "stars": [], "topic_id": 18297, "date_created": 1302386183.1945291, "message": "wait am I github's \"community manager\"?  I think I'm the person that's supposed to be nice to you users", "group_id": 4804, "id": 605814}, {"user_id": 15318, "stars": [], "topic_id": 18297, "date_created": 1302386580.4163029, "message": "his talk is on this very thing, I believe", "group_id": 4804, "id": 605846}, {"user_id": 18149, "stars": [], "topic_id": 18297, "date_created": 1302386336.209727, "message": "auto-generated is fine, but doesn't really imply how to *use* the damn thing", "group_id": 4804, "id": 605823}, {"user_id": 18149, "stars": [{"date_created": 1302386374.5223899, "user_id": 1}], "topic_id": 18297, "date_created": 1302386345.706929, "message": "feel like that requires a person", "group_id": 4804, "id": 605824}, {"user_id": 18149, "stars": [], "topic_id": 18297, "date_created": 1302386445.1456251, "message": "@bryanl: agree. python's doc test seems like it could help there. example code becomes docs", "group_id": 4804, "id": 605837}, {"user_id": 2432, "stars": [], "topic_id": 18297, "date_created": 1302386784.450752, "message": "the lower-case e's in this otherwise allcaps font are breaking my retinas", "group_id": 4804, "id": 605864}, {"user_id": 24495, "stars": [{"date_created": 1302386850.785315, "user_id": 28365}, {"date_created": 1302386853.687088, "user_id": 21178}, {"date_created": 1302386886.831646, "user_id": 1899}, {"date_created": 1302387451.7858801, "user_id": 28342}], "topic_id": 18297, "date_created": 1302386838.803961, "message": "We need a tool to write tools for documentation.", "group_id": 4804, "id": 605869}, {"user_id": 1899, "stars": [], "topic_id": 18297, "date_created": 1302387054.1936879, "message": "@perezd yeah, but he does it with autogenerated docs ;)", "group_id": 4804, "id": 605892}, {"user_id": 24495, "stars": [], "topic_id": 18297, "date_created": 1302385866.3338201, "message": "Is it just me, or do those lowercase T's look funny.", "group_id": 4804, "id": 605782}, {"user_id": 1899, "stars": [], "topic_id": 18297, "date_created": 1302386648.724658, "message": "yeah. but only sorta", "group_id": 4804, "id": 605850}, {"user_id": 28365, "stars": [], "topic_id": 18297, "date_created": 1302386811.2611539, "message": "This structure he is presenting now could be templated.", "group_id": 4804, "id": 605867}, {"user_id": 1899, "stars": [], "topic_id": 18297, "date_created": 1302387270.8422041, "message": "+1000 docco.", "group_id": 4804, "id": 605909}, {"user_id": 2432, "stars": [], "topic_id": 18297, "date_created": 1302386897.3300259, "message": "@mrjbq7 oh yeah. yick.", "group_id": 4804, "id": 605874}, {"user_id": 28365, "stars": [], "topic_id": 18297, "date_created": 1302386855.554579, "message": "@mrjbq7 Exactly!", "group_id": 4804, "id": 605870}, {"user_id": 1, "stars": [{"date_created": 1302386292.341589, "user_id": 22563}, {"date_created": 1302387623.05669, "user_id": 8391}], "topic_id": 18297, "date_created": 1302385786.349386, "message": "\"If it\u2019s not documented, I won\u2019t use it. Learn the tips, tools, and techniques you can use to produce great technical documentation.\"", "group_id": 4804, "id": 605776}, {"user_id": 2583, "stars": [], "topic_id": 18297, "date_created": 1302385925.1324799, "message": "@mrjbq7 If by funny you mean awesome, then yes. Such a gorgeous font.", "group_id": 4804, "id": 605792}, {"user_id": 28419, "stars": [], "topic_id": 18297, "date_created": 1302386296.970803, "message": "Does anyone think you could generate the rails guides from the source itself?", "group_id": 4804, "id": 605818}, {"user_id": 28365, "stars": [], "topic_id": 18297, "date_created": 1302387081.6561821, "message": "could be worse. could be plaintex. or just tex", "group_id": 4804, "id": 605896}, {"user_id": 24495, "stars": [], "topic_id": 18297, "date_created": 1302385942.366082, "message": "Yes, yes, that's what I meant.  Awesome.  ;)", "group_id": 4804, "id": 605794}, {"user_id": 1899, "stars": [], "topic_id": 18297, "date_created": 1302386077.427783, "message": "haha, and everyone's like \"PHP's comments are so great!\"", "group_id": 4804, "id": 605807}, {"user_id": 28419, "stars": [], "topic_id": 18297, "date_created": 1302386168.4539161, "message": "Agree", "group_id": 4804, "id": 605813}, {"user_id": 28365, "stars": [], "topic_id": 18297, "date_created": 1302386876.663904, "message": "Then wrap in microformat... etc etc etc ok maybe not....", "group_id": 4804, "id": 605873}, {"user_id": 28419, "stars": [], "topic_id": 18297, "date_created": 1302386938.849309, "message": "Docbool sucks, but you can generate multiple other formats from it", "group_id": 4804, "id": 605875}, {"user_id": 28419, "stars": [], "topic_id": 18297, "date_created": 1302386946.024045, "message": "Docbook", "group_id": 4804, "id": 605877}, {"user_id": 22563, "stars": [{"date_created": 1302388952.6044321, "user_id": 8391}, {"date_created": 1302392741.11672, "user_id": 4078}], "topic_id": 18297, "date_created": 1302387146.199245, "message": "Indeed, it's this sphinx: http://sphinx.pocoo.org/", "group_id": 4804, "id": 605899}, {"user_id": 18149, "stars": [], "topic_id": 18297, "date_created": 1302386326.732985, "message": "The early rails wikis were useful, but had frequent gardeners.", "group_id": 4804, "id": 605821}, {"user_id": 1899, "stars": [], "topic_id": 18297, "date_created": 1302386478.8763559, "message": "I don't either, but it's a comment sentiment", "group_id": 4804, "id": 605840}, {"user_id": 28419, "stars": [], "topic_id": 18297, "date_created": 1302387428.3251491, "message": "I like generated docs", "group_id": 4804, "id": 605921}, {"user_id": 28419, "stars": [], "topic_id": 18297, "date_created": 1302386379.2336881, "message": "There are multile types of docs.  How to use it isn't the same as how it works", "group_id": 4804, "id": 605828}, {"user_id": 24495, "stars": [], "topic_id": 18297, "date_created": 1302387239.4008391, "message": "and this one: https://bitbucket.org/birkenfeld/sphinx/overview (ewww, hg)", "group_id": 4804, "id": 605906}, {"user_id": 8391, "stars": [{"date_created": 1302388570.1594541, "user_id": 1}], "topic_id": 18297, "date_created": 1302388501.309777, "message": "Sphinx ftw.", "group_id": 4804, "id": 605993}, {"user_id": 28353, "stars": [], "topic_id": 18297, "date_created": 1302386411.0426869, "message": "@jakebellacera inline comments work well if you're constantly in the source, but if you just want to use a framework (e.g. spring, struts, etc) i feel like exterior documentation works better", "group_id": 4804, "id": 605833}, {"user_id": 28456, "stars": [], "topic_id": 18297, "date_created": 1302386464.3378861, "message": "@rhoads_zach Definitely. Which is why it doesn't work all the time. WordPress has excellent wiki documentation, you can find literally everything you need. Always one of my favorite examples of quality documentation", "group_id": 4804, "id": 605838}, {"user_id": 28419, "stars": [], "topic_id": 18297, "date_created": 1302386552.1835761, "message": "Now we really disagee", "group_id": 4804, "id": 605843}, {"user_id": 28457, "stars": [], "topic_id": 18297, "date_created": 1302386591.8499761, "message": "Slam!", "group_id": 4804, "id": 605848}, {"user_id": 28454, "stars": [], "topic_id": 18297, "date_created": 1302386809.0503261, "message": "and a's", "group_id": 4804, "id": 605866}, {"user_id": 21178, "stars": [], "topic_id": 18297, "date_created": 1302386873.607537, "message": "heh", "group_id": 4804, "id": 605872}, {"user_id": 28367, "stars": [], "topic_id": 18297, "date_created": 1302387326.309088, "message": "sidenote: i had problems getting docco to work in large projects with multiple subdirectories, so i made a docco-alike that handles it (plus lets you configure templates, languages, etc, without having to fork): http://github.com/chrisdickinson/narrativ", "group_id": 4804, "id": 605915}, {"user_id": 15318, "stars": [], "topic_id": 18297, "date_created": 1302386559.2592549, "message": "Jeremy Ashkenas just had the gauntlet thrown down", "group_id": 4804, "id": 605845}, {"user_id": 1899, "stars": [], "topic_id": 18297, "date_created": 1302386673.8410051, "message": "i mean, docco is only kinda autogenerated. it's technically so, but i think it's qualitatively different.", "group_id": 4804, "id": 605853}, {"user_id": 18149, "stars": [], "topic_id": 18297, "date_created": 1302386758.9091151, "message": "ok, this part is excellent", "group_id": 4804, "id": 605858}, {"user_id": 15318, "stars": [], "topic_id": 18297, "date_created": 1302387035.6874549, "message": "his talk was about can code be literature, i believe", "group_id": 4804, "id": 605884}, {"user_id": 21178, "stars": [], "topic_id": 18297, "date_created": 1302387073.8692751, "message": "And no, it isn't the other sphinx", "group_id": 4804, "id": 605895}, {"user_id": 28365, "stars": [], "topic_id": 18297, "date_created": 1302386676.414768, "message": "fractal is a good model", "group_id": 4804, "id": 605854}, {"user_id": 1899, "stars": [], "topic_id": 18297, "date_created": 1302387370.1632669, "message": "oh yeah? it's fairly easy with rocco, at least.", "group_id": 4804, "id": 605916}, {"user_id": 1899, "stars": [], "topic_id": 18297, "date_created": 1302387392.1011701, "message": "i also totally reccomend stealing rocco's rake task for building its own docs, it gives you 'rake pages' which will generate your docs and commit them to your gh-pages branch", "group_id": 4804, "id": 605917}, {"user_id": 24495, "stars": [], "topic_id": 18297, "date_created": 1302386800.889838, "message": "@r00k The a's too.", "group_id": 4804, "id": 605865}, {"user_id": 21178, "stars": [], "topic_id": 18297, "date_created": 1302387098.2250309, "message": "The one that does fulltext search", "group_id": 4804, "id": 605897}, {"user_id": 2432, "stars": [], "topic_id": 18297, "date_created": 1302387223.119947, "message": "docco output is particularly lovely", "group_id": 4804, "id": 605904}, {"user_id": 1899, "stars": [], "topic_id": 18297, "date_created": 1302387276.6193061, "message": "i wish rocco pulled in the new stylesheets though", "group_id": 4804, "id": 605910}, {"user_id": 28419, "stars": [], "topic_id": 18297, "date_created": 1302387441.6555071, "message": "Right from a CI build", "group_id": 4804, "id": 605923}]