convore.json/groups/pycon-2011/writing-great-documentation/messages.json

[{"user_id": 205, "stars": [], "topic_id": 12602, "date_created": 1299947093.5081091, "message": "@daniellindsley I did that on my badge before it was cool :)", "group_id": 373, "id": 333213}, {"user_id": 4748, "stars": [], "topic_id": 12602, "date_created": 1299947110.362458, "message": "@dcolish only for certain rare projects; Django is a rare case for that.", "group_id": 373, "id": 333215}, {"user_id": 4748, "stars": [], "topic_id": 12602, "date_created": 1299946668.765516, "message": "I'd appreciate it if Jacob would just start.", "group_id": 373, "id": 333136}, {"user_id": 8000, "stars": [{"date_created": 1299946490.567668, "user_id": 4748}, {"date_created": 1299946493.405936, "user_id": 20508}, {"date_created": 1299946774.9674101, "user_id": 20599}], "topic_id": 12602, "date_created": 1299946483.3225801, "message": "imo they should start anyway... Alex Gaynor Vs. Jacob Vs. JLG Lift", "group_id": 373, "id": 333091}, {"user_id": 13954, "stars": [], "topic_id": 12602, "date_created": 1299947132.1081531, "message": "Are the slides posted for this anywhere?", "group_id": 373, "id": 333222}, {"user_id": 8000, "stars": [], "topic_id": 12602, "date_created": 1299947441.456095, "message": "@offby1 so that's why djangos devs are in such high demand!", "group_id": 373, "id": 333265}, {"user_id": 14463, "stars": [{"date_created": 1299947600.5347281, "user_id": 4748}, {"date_created": 1299947783.7184651, "user_id": 8000}, {"date_created": 1299948962.7867701, "user_id": 19747}], "topic_id": 12602, "date_created": 1299947591.449177, "message": "Wikis also suck because they aren't in the code repo, so they easily get out of sync (at least, in my experience\u2026)", "group_id": 373, "id": 333296}, {"user_id": 14463, "stars": [], "topic_id": 12602, "date_created": 1299947607.276552, "message": "(\"suck\" might be too strong\u2026 But still)", "group_id": 373, "id": 333300}, {"user_id": 7018, "stars": [], "topic_id": 12602, "date_created": 1299946407.370203, "message": "I hope those air walls are ok in there.", "group_id": 373, "id": 333064}, {"user_id": 210, "stars": [{"date_created": 1299946438.8227789, "user_id": 20265}, {"date_created": 1299946877.134069, "user_id": 14463}, {"date_created": 1299946914.8731749, "user_id": 20162}], "topic_id": 12602, "date_created": 1299946423.747473, "message": "Clever. Jacob's twitter username is bolded within his email addy.", "group_id": 373, "id": 333071}, {"user_id": 14463, "stars": [], "topic_id": 12602, "date_created": 1299947546.3914881, "message": "+1 on getting the ball rolling. The hour I spent getting Sphinx setup for my project, despite not having very much to write at that point, paid off hugely because, when I *did* have something to write about, it was very easy to put it in the right place.", "group_id": 373, "id": 333283}, {"user_id": 20709, "stars": [], "topic_id": 12602, "date_created": 1299947590.6839499, "message": "/me dies", "group_id": 373, "id": 333295}, {"user_id": 20420, "stars": [], "topic_id": 12602, "date_created": 1299947074.4569409, "message": "Hey, I wanted to hear both of these talks anyway", "group_id": 373, "id": 333209}, {"user_id": 20709, "stars": [], "topic_id": 12602, "date_created": 1299946455.540432, "message": "damn. I should have done that on my business cards", "group_id": 373, "id": 333082}, {"user_id": 5639, "stars": [], "topic_id": 12602, "date_created": 1299947087.2784319, "message": "I hope he addresses the \"code is the doc\" epidemic.", "group_id": 373, "id": 333211}, {"user_id": 4748, "stars": [], "topic_id": 12602, "date_created": 1299947413.2748959, "message": "Who should write documentation? Easy: Hire the Django devs to do yours.", "group_id": 373, "id": 333257}, {"user_id": 18601, "stars": [{"date_created": 1299947565.6931159, "user_id": 20599}, {"date_created": 1299947569.9187269, "user_id": 1979}, {"date_created": 1299947569.9811201, "user_id": 8000}, {"date_created": 1299947577.714895, "user_id": 5639}, {"date_created": 1299947592.310169, "user_id": 6310}], "topic_id": 12602, "date_created": 1299947550.567198, "message": "welcome to the team bitch, now write our docs", "group_id": 373, "id": 333285}, {"user_id": 20599, "stars": [], "topic_id": 12602, "date_created": 1299947124.650835, "message": "@ericholscher is it mainstream now?", "group_id": 373, "id": 333219}, {"user_id": 20599, "stars": [], "topic_id": 12602, "date_created": 1299947152.674356, "message": "@nyxtom not yet i think", "group_id": 373, "id": 333227}, {"user_id": 20508, "stars": [{"date_created": 1299946482.8043039, "user_id": 4748}, {"date_created": 1299946525.69385, "user_id": 228}, {"date_created": 1299946818.535574, "user_id": 1924}], "topic_id": 12602, "date_created": 1299946468.9967899, "message": "This intermission sponsored by JLG Lift Equipment: Extending Your Reach. http://www.jlg.com", "group_id": 373, "id": 333084}, {"user_id": 20709, "stars": [], "topic_id": 12602, "date_created": 1299946582.0544679, "message": "looks like success", "group_id": 373, "id": 333119}, {"user_id": 5639, "stars": [{"date_created": 1299947500.957938, "user_id": 4747}], "topic_id": 12602, "date_created": 1299947028.291214, "message": "not that he's wrong or anything :)", "group_id": 373, "id": 333203}, {"user_id": 6559, "stars": [], "topic_id": 12602, "date_created": 1299947159.2853961, "message": "what is mainstream?", "group_id": 373, "id": 333229}, {"user_id": 13954, "stars": [], "topic_id": 12602, "date_created": 1299947478.1861269, "message": "This is true. #pycon theme \"we're hiring\"", "group_id": 373, "id": 333270}, {"user_id": 7018, "stars": [], "topic_id": 12602, "date_created": 1299947913.7137461, "message": "was that frython?", "group_id": 373, "id": 333373}, {"user_id": 6279, "stars": [], "topic_id": 12602, "date_created": 1299948137.6234641, "message": "I think successful documentation is a careful balance of both.", "group_id": 373, "id": 333408}, {"user_id": 4748, "stars": [], "topic_id": 12602, "date_created": 1299946682.8858249, "message": "I'm sure he'll be loud enough to be heard.", "group_id": 373, "id": 333137}, {"user_id": 6279, "stars": [{"date_created": 1299946900.9632349, "user_id": 20590}, {"date_created": 1299946923.9170599, "user_id": 9663}, {"date_created": 1299946957.7290161, "user_id": 228}], "topic_id": 12602, "date_created": 1299946887.261889, "message": "I feel the wall construction intermission would have been improved by some Benny Hill music.", "group_id": 373, "id": 333173}, {"user_id": 8000, "stars": [{"date_created": 1299948453.935333, "user_id": 4107}], "topic_id": 12602, "date_created": 1299947495.857811, "message": "#HACK <-- the most important line of documentation that I use", "group_id": 373, "id": 333275}, {"user_id": 4748, "stars": [], "topic_id": 12602, "date_created": 1299947610.9459839, "message": "@wolever I starred that comment so hard.", "group_id": 373, "id": 333301}, {"user_id": 6279, "stars": [], "topic_id": 12602, "date_created": 1299948086.5666649, "message": "Eh.  I might slightly disagree on that last point.  Software is great for writing *reference*, which is part of documentation.", "group_id": 373, "id": 333402}, {"user_id": 4748, "stars": [], "topic_id": 12602, "date_created": 1299946347.392101, "message": "Off to a bumpy start. Or not, so to speak.", "group_id": 373, "id": 333045}, {"user_id": 8000, "stars": [], "topic_id": 12602, "date_created": 1299946549.478307, "message": "oh whoops it's Jim Fulton not Alex Gaynor", "group_id": 373, "id": 333111}, {"user_id": 20599, "stars": [{"date_created": 1299947089.959614, "user_id": 8000}], "topic_id": 12602, "date_created": 1299947076.3523591, "message": "its quicker than reading the code", "group_id": 373, "id": 333210}, {"user_id": 1175, "stars": [], "topic_id": 12602, "date_created": 1299948214.409739, "message": "doesn't this conflict with his earlier point?", "group_id": 373, "id": 333417}, {"user_id": 20265, "stars": [], "topic_id": 12602, "date_created": 1299948362.4810071, "message": "@mwhooker I'm hoping there is a question asked to clarify this", "group_id": 373, "id": 333439}, {"user_id": 8000, "stars": [{"date_created": 1299946926.4833879, "user_id": 9663}], "topic_id": 12602, "date_created": 1299946900.3567159, "message": "and also 3x speed", "group_id": 373, "id": 333175}, {"user_id": 5639, "stars": [], "topic_id": 12602, "date_created": 1299946966.440906, "message": "heh. He's telling us all about what he just said he wasn't going to tell us about ;-P", "group_id": 373, "id": 333192}, {"user_id": 20709, "stars": [], "topic_id": 12602, "date_created": 1299947589.7166669, "message": "umm, I use a wiki for documentation..", "group_id": 373, "id": 333294}, {"user_id": 20599, "stars": [{"date_created": 1299946886.8589189, "user_id": 14463}], "topic_id": 12602, "date_created": 1299946782.182421, "message": "That lift IS pretty awesome", "group_id": 373, "id": 333155}, {"user_id": 20599, "stars": [{"date_created": 1299947347.454581, "user_id": 8000}, {"date_created": 1299947354.2977741, "user_id": 20265}, {"date_created": 1299947406.4181449, "user_id": 7018}], "topic_id": 12602, "date_created": 1299947278.5168991, "message": "strftime.org I need to remember that one", "group_id": 373, "id": 333242}, {"user_id": 20599, "stars": [{"date_created": 1299947412.4982369, "user_id": 9663}], "topic_id": 12602, "date_created": 1299947401.815134, "message": "trolls should write documentation", "group_id": 373, "id": 333255}, {"user_id": 20599, "stars": [{"date_created": 1299947552.172194, "user_id": 14463}], "topic_id": 12602, "date_created": 1299947528.990695, "message": "what happens in the documentation stays in the documentation", "group_id": 373, "id": 333281}, {"user_id": 20599, "stars": [], "topic_id": 12602, "date_created": 1299947657.6477709, "message": "@wiredfool what process do you use to keep it up to date?", "group_id": 373, "id": 333313}, {"user_id": 20682, "stars": [], "topic_id": 12602, "date_created": 1299948294.1018319, "message": "Classic Talk Structure: Tell them what you're going to tell them, tell them, tell them what you just told them.", "group_id": 373, "id": 333429}, {"user_id": 19652, "stars": [], "topic_id": 12602, "date_created": 1299948357.360899, "message": "@adrianh really? It doesn't looks like it from the web", "group_id": 373, "id": 333438}, {"user_id": 1130, "stars": [{"date_created": 1299946825.735184, "user_id": 6279}, {"date_created": 1299946874.050658, "user_id": 19655}, {"date_created": 1299946951.2405441, "user_id": 20599}], "topic_id": 12602, "date_created": 1299946810.006778, "message": "Someone should get on the lift and do their talk!", "group_id": 373, "id": 333161}, {"user_id": 20972, "stars": [{"date_created": 1299947422.450978, "user_id": 14463}, {"date_created": 1299948240.8413939, "user_id": 19652}], "topic_id": 12602, "date_created": 1299947414.256716, "message": "I think strftime.org is possibly the most useful thing I've learned at pycon this year.", "group_id": 373, "id": 333258}, {"user_id": 1979, "stars": [], "topic_id": 12602, "date_created": 1299947652.3357511, "message": "designers and managers tend to not understand simplest vcs commands", "group_id": 373, "id": 333311}, {"user_id": 20709, "stars": [{"date_created": 1299947678.8571661, "user_id": 6279}, {"date_created": 1299947714.3847959, "user_id": 14463}], "topic_id": 12602, "date_created": 1299947670.473556, "message": "guilt", "group_id": 373, "id": 333316}, {"user_id": 20162, "stars": [], "topic_id": 12602, "date_created": 1299948584.2604921, "message": "I'm gonna let you finish, but ORG mode is the best text format of all time", "group_id": 373, "id": 333475}, {"user_id": 14463, "stars": [], "topic_id": 12602, "date_created": 1299947414.3884051, "message": "+1 - troll docs are the best kind of docs.", "group_id": 373, "id": 333259}, {"user_id": 20953, "stars": [{"date_created": 1299948951.865207, "user_id": 1175}], "topic_id": 12602, "date_created": 1299948245.4376249, "message": "@mwhooker you stil write the docs with sphinx, it just formats it", "group_id": 373, "id": 333424}, {"user_id": 210, "stars": [], "topic_id": 12602, "date_created": 1299947156.482981, "message": "@nyxtom They will be.", "group_id": 373, "id": 333228}, {"user_id": 20682, "stars": [], "topic_id": 12602, "date_created": 1299947178.2503359, "message": "Heh, I had some similar thoughts a few months ago: http://blog.wearpants.org/from-good-code-to-great", "group_id": 373, "id": 333233}, {"user_id": 20709, "stars": [], "topic_id": 12602, "date_created": 1299947639.347991, "message": "to be fair, I do it for userfacing docs, and I write most of it", "group_id": 373, "id": 333308}, {"user_id": 14463, "stars": [], "topic_id": 12602, "date_created": 1299947687.50299, "message": "Yea, it is tricky to get non-coders contribute to in-code docs\u2026 They aren't perfect, for sure. I just prefer them. cc:@mishok13,@wiredfool", "group_id": 373, "id": 333320}, {"user_id": 20709, "stars": [], "topic_id": 12602, "date_created": 1299947802.9587431, "message": "jumping back up for a bit are the docs that explain all the bits of (eg) a dialog box using slightly expanded versions of the lables, but not explain why the hell I'd want it or why it might not be enabling the one option I want that's greyed out", "group_id": 373, "id": 333347}, {"user_id": 1175, "stars": [], "topic_id": 12602, "date_created": 1299948109.750294, "message": "@ryanpetrello agreed.", "group_id": 373, "id": 333404}, {"user_id": 19652, "stars": [], "topic_id": 12602, "date_created": 1299948279.1285701, "message": "So when is django moving to sphinx? obj wait trolling is over?", "group_id": 373, "id": 333427}, {"user_id": 19652, "stars": [], "topic_id": 12602, "date_created": 1299948295.092376, "message": "Ohhh not obj stupid iPad...", "group_id": 373, "id": 333430}, {"user_id": 20590, "stars": [], "topic_id": 12602, "date_created": 1299948306.011059, "message": "@elpargo: Django's docs are already on Sphinx", "group_id": 373, "id": 333432}, {"user_id": 20599, "stars": [], "topic_id": 12602, "date_created": 1299948442.5888629, "message": "project defense is a good idea", "group_id": 373, "id": 333454}, {"user_id": 20599, "stars": [], "topic_id": 12602, "date_created": 1299948226.12516, "message": "rtfd++", "group_id": 373, "id": 333420}, {"user_id": 20599, "stars": [], "topic_id": 12602, "date_created": 1299948350.2048919, "message": "if you've got doc tests run selenium and take snapshots", "group_id": 373, "id": 333435}, {"user_id": 20590, "stars": [], "topic_id": 12602, "date_created": 1299948419.5180681, "message": "@elpargo Yes, really :)", "group_id": 373, "id": 333451}, {"user_id": 233, "stars": [{"date_created": 1299948243.1323481, "user_id": 20599}, {"date_created": 1299948313.7736361, "user_id": 9663}, {"date_created": 1299949471.867574, "user_id": 1822}], "topic_id": 12602, "date_created": 1299948236.789794, "message": "Use these: http://sphinx.pocoo.org/ http://readthedocs.org/", "group_id": 373, "id": 333422}, {"user_id": 20599, "stars": [], "topic_id": 12602, "date_created": 1299948277.151679, "message": "literate programming ftw", "group_id": 373, "id": 333426}, {"user_id": 228, "stars": [], "topic_id": 12602, "date_created": 1299948422.8935959, "message": "(@elpargo se: http://sphinx.pocoo.org/theming.html)", "group_id": 373, "id": 333452}, {"user_id": 20599, "stars": [{"date_created": 1299948533.0977719, "user_id": 1243}], "topic_id": 12602, "date_created": 1299948514.8101909, "message": "what about internationalization of documents?", "group_id": 373, "id": 333460}, {"user_id": 20599, "stars": [], "topic_id": 12602, "date_created": 1299948212.1265719, "message": "sphinx isnt really automatic", "group_id": 373, "id": 333416}, {"user_id": 6279, "stars": [], "topic_id": 12602, "date_created": 1299948165.652251, "message": "...and that balance likely depends on your tool and your audience.", "group_id": 373, "id": 333412}, {"user_id": 228, "stars": [], "topic_id": 12602, "date_created": 1299948217.1354671, "message": "rtfd plug woo", "group_id": 373, "id": 333418}, {"user_id": 228, "stars": [], "topic_id": 12602, "date_created": 1299948375.702668, "message": "@elpargo sphinx is a helluva tool", "group_id": 373, "id": 333441}, {"user_id": 210, "stars": [], "topic_id": 12602, "date_created": 1299948391.3982251, "message": "@elpargo All written in RST & presented online with a custom Sphinx theme.", "group_id": 373, "id": 333444}, {"user_id": 19652, "stars": [], "topic_id": 12602, "date_created": 1299948523.660589, "message": "Nice! Good to know. I didn't even noticed that. Sphinx is so awesome", "group_id": 373, "id": 333461}, {"user_id": 210, "stars": [], "topic_id": 12602, "date_created": 1299948429.561548, "message": "@elpargo http://code.djangoproject.com/browser/django/trunk/docs", "group_id": 373, "id": 333453}, {"user_id": 20420, "stars": [], "topic_id": 12602, "date_created": 1299948788.2052929, "message": "what was the literate python programming tool?", "group_id": 373, "id": 333520}, {"user_id": 20265, "stars": [], "topic_id": 12602, "date_created": 1299948913.1195419, "message": "@tivoli Pycco: http://fitzgen.github.com/pycco/", "group_id": 373, "id": 333545}, {"user_id": 4748, "stars": [], "topic_id": 12602, "date_created": 1299948577.91663, "message": "Nice; he used @bitprophet's fabric docs as the example of good tools.", "group_id": 373, "id": 333472}, {"user_id": 5852, "stars": [{"date_created": 1299952050.9631441, "user_id": 20265}], "topic_id": 12602, "date_created": 1299950741.0984459, "message": "http://dl.dropbox.com/u/20553/Writing%20Great%20Documentation.pdf - slides if you wanna ponder that chart a bit more.", "group_id": 373, "id": 333986}, {"user_id": 20420, "stars": [], "topic_id": 12602, "date_created": 1299951014.760663, "message": "@pimlottc thanks", "group_id": 373, "id": 334011}, {"user_id": 20420, "stars": [], "topic_id": 12602, "date_created": 1299951039.1349981, "message": "@jacobian perfect", "group_id": 373, "id": 334016}]