<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
		>
<channel>
	<title>Comments on: Open Source Is Really About Documentation &#8211; Twisted vs. Tornado</title>
	<atom:link href="http://www.littlehart.net/atthekeyboard/2009/09/14/open-source-is-really-about-documentation/feed/" rel="self" type="application/rss+xml" />
	<link>http://www.littlehart.net/atthekeyboard/2009/09/14/open-source-is-really-about-documentation/</link>
	<description>Facebook should&#039;ve be written in unicornSchemaLang, because everyone *knows* that PHP is no good for anything, right?</description>
	<lastBuildDate>Mon, 09 Aug 2010 16:04:35 +0000</lastBuildDate>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
	<generator>http://wordpress.org/?v=3.0.1</generator>
	<item>
		<title>By: The Daily Reviewer</title>
		<link>http://www.littlehart.net/atthekeyboard/2009/09/14/open-source-is-really-about-documentation/comment-page-1/#comment-14041</link>
		<dc:creator>The Daily Reviewer</dc:creator>
		<pubDate>Tue, 22 Sep 2009 04:02:00 +0000</pubDate>
		<guid isPermaLink="false">http://www.littlehart.net/atthekeyboard/?p=534#comment-14041</guid>
		<description>Hi!

Congratulations! Your readers have submitted and voted for your blog at The Daily Reviewer. We compiled an exclusive list of the Top 100 php Blogs, and we are glad to let you know that your blog was included! You can see it at http://thedailyreviewer.com/top/php

You can claim your Top 100 Blogs Award here : http://thedailyreviewer.com/pages/badges/php

P.S. This is a one-time notice to let you know your blog was included in one of our Top 100 Blog categories. You might get notices if you are listed in two or more categories.

P.P.S. If for some reason you want your blog removed from our list, just send an email to angelina@thedailyreviewer.com with the subject line &quot;REMOVE&quot; and the link to your blog in the body of the message.

Cheers!

Angelina Mizaki
Selection Committee President
The Daily Reviewer
http://thedailyreviewer.com</description>
		<content:encoded><![CDATA[<p>Hi!</p>
<p>Congratulations! Your readers have submitted and voted for your blog at The Daily Reviewer. We compiled an exclusive list of the Top 100 php Blogs, and we are glad to let you know that your blog was included! You can see it at <a href="http://thedailyreviewer.com/top/php" rel="nofollow">http://thedailyreviewer.com/top/php</a></p>
<p>You can claim your Top 100 Blogs Award here : <a href="http://thedailyreviewer.com/pages/badges/php" rel="nofollow">http://thedailyreviewer.com/pages/badges/php</a></p>
<p>P.S. This is a one-time notice to let you know your blog was included in one of our Top 100 Blog categories. You might get notices if you are listed in two or more categories.</p>
<p>P.P.S. If for some reason you want your blog removed from our list, just send an email to <a href="mailto:angelina@thedailyreviewer.com">angelina@thedailyreviewer.com</a> with the subject line &#8220;REMOVE&#8221; and the link to your blog in the body of the message.</p>
<p>Cheers!</p>
<p>Angelina Mizaki<br />
Selection Committee President<br />
The Daily Reviewer<br />
<a href="http://thedailyreviewer.com" rel="nofollow">http://thedailyreviewer.com</a></p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Greg Grossmeier (greg) 's status on Wednesday, 16-Sep-09 21:28:00 UTC - Identi.ca</title>
		<link>http://www.littlehart.net/atthekeyboard/2009/09/14/open-source-is-really-about-documentation/comment-page-1/#comment-13995</link>
		<dc:creator>Greg Grossmeier (greg) 's status on Wednesday, 16-Sep-09 21:28:00 UTC - Identi.ca</dc:creator>
		<pubDate>Wed, 16 Sep 2009 21:28:08 +0000</pubDate>
		<guid isPermaLink="false">http://www.littlehart.net/atthekeyboard/?p=534#comment-13995</guid>
		<description>[...]  http://www.littlehart.net/atthekeyboard/2009/09/14/open-source-is-really-about-documentation/?utm_s...       a few seconds ago  from  Gwibber [...]</description>
		<content:encoded><![CDATA[<p>[...]  <a href="http://www.littlehart.net/atthekeyboard/2009/09/14/open-source-is-really-about-documentation/?utm_s.." rel="nofollow">http://www.littlehart.net/atthekeyboard/2009/09/14/open-source-is-really-about-documentation/?utm_s..</a>.       a few seconds ago  from  Gwibber [...]</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Random Links #48 &#124; YASDW - yet another software developer weblog</title>
		<link>http://www.littlehart.net/atthekeyboard/2009/09/14/open-source-is-really-about-documentation/comment-page-1/#comment-13992</link>
		<dc:creator>Random Links #48 &#124; YASDW - yet another software developer weblog</dc:creator>
		<pubDate>Wed, 16 Sep 2009 19:24:30 +0000</pubDate>
		<guid isPermaLink="false">http://www.littlehart.net/atthekeyboard/?p=534#comment-13992</guid>
		<description>[...] Open Source Is Really About Documentation Ja, aber ob man es so generalisieren kann? [...]</description>
		<content:encoded><![CDATA[<p>[...] Open Source Is Really About Documentation Ja, aber ob man es so generalisieren kann? [...]</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Elizabeth Leddy</title>
		<link>http://www.littlehart.net/atthekeyboard/2009/09/14/open-source-is-really-about-documentation/comment-page-1/#comment-13990</link>
		<dc:creator>Elizabeth Leddy</dc:creator>
		<pubDate>Wed, 16 Sep 2009 17:26:00 +0000</pubDate>
		<guid isPermaLink="false">http://www.littlehart.net/atthekeyboard/?p=534#comment-13990</guid>
		<description>Its weird because this bickering seems to be about twisted.web[2] and not twisted in general. The twisted framework touches so many more protocols than tornado - I&#039;d like to see tornado switch all of its interfaces from https to xmlrpc or  in one line of code like twisted can do. I&#039;ve never used twisted for handling http requests but get lower in the stack and I doubt you&#039;ll find a tool better for the job. If you are programming tcp you&#039;re probably crazy enough to not need thorough documentation anyways.

Tornado is documented like a web server which is probably why tornado seems &quot;better documented&quot;. Apples and oranges.</description>
		<content:encoded><![CDATA[<p>Its weird because this bickering seems to be about twisted.web[2] and not twisted in general. The twisted framework touches so many more protocols than tornado &#8211; I&#8217;d like to see tornado switch all of its interfaces from https to xmlrpc or  in one line of code like twisted can do. I&#8217;ve never used twisted for handling http requests but get lower in the stack and I doubt you&#8217;ll find a tool better for the job. If you are programming tcp you&#8217;re probably crazy enough to not need thorough documentation anyways.</p>
<p>Tornado is documented like a web server which is probably why tornado seems &#8220;better documented&#8221;. Apples and oranges.</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Chris Hartjes</title>
		<link>http://www.littlehart.net/atthekeyboard/2009/09/14/open-source-is-really-about-documentation/comment-page-1/#comment-13988</link>
		<dc:creator>Chris Hartjes</dc:creator>
		<pubDate>Wed, 16 Sep 2009 13:08:26 +0000</pubDate>
		<guid isPermaLink="false">http://www.littlehart.net/atthekeyboard/?p=534#comment-13988</guid>
		<description>@Jean-Paul

I thought that is what this page said http://twistedmatrix.com/trac/wiki/TwistedWebPlan

After another read through, I realize what confused me: that you are taking stuff from twisted.web2 and rolling it back into twisted.web.  This quote from there is very telling:

&quot;This is mostly a problem of perception, but there are some real issues.&quot;

I thought things were going the opposite direction, with twisted.web being phased out and rolled into twisted.web2.</description>
		<content:encoded><![CDATA[<p>@Jean-Paul</p>
<p>I thought that is what this page said <a href="http://twistedmatrix.com/trac/wiki/TwistedWebPlan" rel="nofollow">http://twistedmatrix.com/trac/wiki/TwistedWebPlan</a></p>
<p>After another read through, I realize what confused me: that you are taking stuff from twisted.web2 and rolling it back into twisted.web.  This quote from there is very telling:</p>
<p>&#8220;This is mostly a problem of perception, but there are some real issues.&#8221;</p>
<p>I thought things were going the opposite direction, with twisted.web being phased out and rolled into twisted.web2.</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Chris Hartjes</title>
		<link>http://www.littlehart.net/atthekeyboard/2009/09/14/open-source-is-really-about-documentation/comment-page-1/#comment-13987</link>
		<dc:creator>Chris Hartjes</dc:creator>
		<pubDate>Wed, 16 Sep 2009 13:04:25 +0000</pubDate>
		<guid isPermaLink="false">http://www.littlehart.net/atthekeyboard/?p=534#comment-13987</guid>
		<description>@cris

I think it IS obvious that I did not dig deep enough, but this raises an interesting question:  how much work should you expect users of your tools do in order to figure out how to use it?  Twisted appears to have a very high level of expectations for those who want to use it.  I imagine I am not the only one who could not make the commitment to read every single piece of documentation in order to figure out how to build something with it.  Laziness maybe, or perhaps just different expectations on what documentation should contain.</description>
		<content:encoded><![CDATA[<p>@cris</p>
<p>I think it IS obvious that I did not dig deep enough, but this raises an interesting question:  how much work should you expect users of your tools do in order to figure out how to use it?  Twisted appears to have a very high level of expectations for those who want to use it.  I imagine I am not the only one who could not make the commitment to read every single piece of documentation in order to figure out how to build something with it.  Laziness maybe, or perhaps just different expectations on what documentation should contain.</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Jean-Paul Calderone</title>
		<link>http://www.littlehart.net/atthekeyboard/2009/09/14/open-source-is-really-about-documentation/comment-page-1/#comment-13986</link>
		<dc:creator>Jean-Paul Calderone</dc:creator>
		<pubDate>Wed, 16 Sep 2009 13:00:25 +0000</pubDate>
		<guid isPermaLink="false">http://www.littlehart.net/atthekeyboard/?p=534#comment-13986</guid>
		<description>Hey again Chris,

Thanks for the response.  I just need to correct one thing.  You said &quot;When you read stuff like “Twisted.web is being deprecated and Twisted.web2 is under development”, well, you can understand why people look at Tornado and say they would rather use it than Twisted.web.&quot; but Twisted Web is not being deprecated.  Can you tell me where you read this so I can correct it?

Thanks. :)</description>
		<content:encoded><![CDATA[<p>Hey again Chris,</p>
<p>Thanks for the response.  I just need to correct one thing.  You said &#8220;When you read stuff like “Twisted.web is being deprecated and Twisted.web2 is under development”, well, you can understand why people look at Tornado and say they would rather use it than Twisted.web.&#8221; but Twisted Web is not being deprecated.  Can you tell me where you read this so I can correct it?</p>
<p>Thanks. <img src='http://www.littlehart.net/atthekeyboard/wp-includes/images/smilies/icon_smile.gif' alt=':)' class='wp-smiley' /> </p>
]]></content:encoded>
	</item>
	<item>
		<title>By: gwern</title>
		<link>http://www.littlehart.net/atthekeyboard/2009/09/14/open-source-is-really-about-documentation/comment-page-1/#comment-13984</link>
		<dc:creator>gwern</dc:creator>
		<pubDate>Wed, 16 Sep 2009 12:27:13 +0000</pubDate>
		<guid isPermaLink="false">http://www.littlehart.net/atthekeyboard/?p=534#comment-13984</guid>
		<description>&gt; Why are the Twisted folks getting all twisted (look how funny I am!) up about this?

Actually, it&#039;s not very funny because &#039;getting all twisted up&#039; doesn&#039;t pass for normal English; you want &#039;getting all wound up&#039; - &#039;wound up&#039; being the same as &#039;twisted&#039;, it&#039;s even cleverer.</description>
		<content:encoded><![CDATA[<p>&gt; Why are the Twisted folks getting all twisted (look how funny I am!) up about this?</p>
<p>Actually, it&#8217;s not very funny because &#8216;getting all twisted up&#8217; doesn&#8217;t pass for normal English; you want &#8216;getting all wound up&#8217; &#8211; &#8216;wound up&#8217; being the same as &#8216;twisted&#8217;, it&#8217;s even cleverer.</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Another twistee</title>
		<link>http://www.littlehart.net/atthekeyboard/2009/09/14/open-source-is-really-about-documentation/comment-page-1/#comment-13983</link>
		<dc:creator>Another twistee</dc:creator>
		<pubDate>Wed, 16 Sep 2009 11:47:23 +0000</pubDate>
		<guid isPermaLink="false">http://www.littlehart.net/atthekeyboard/?p=534#comment-13983</guid>
		<description>Same experience.

I even bought the twisted book and it&#039;s not all that helpful in my opinion. 

If the book had been: 1/3 lower-level networking basics, 1/3 architecture overview / design discussion, 1/3 serious twisted projects twisted would be in very widespread use.

As is the twisted book is a hurried tour of twisted usage for some simple apps, kind of like a bound volume of annotated hello-world for various twisted modules. It&#039;s short, too.

It is a nice extra bit of info but pretty far away from what it&#039;d take to turn you into a competent twisted developer.

It&#039;s really too bad, too, b/c from what I can tell twisted is an amazing piece of work, it&#039;s just well-nigh unapproachable.</description>
		<content:encoded><![CDATA[<p>Same experience.</p>
<p>I even bought the twisted book and it&#8217;s not all that helpful in my opinion. </p>
<p>If the book had been: 1/3 lower-level networking basics, 1/3 architecture overview / design discussion, 1/3 serious twisted projects twisted would be in very widespread use.</p>
<p>As is the twisted book is a hurried tour of twisted usage for some simple apps, kind of like a bound volume of annotated hello-world for various twisted modules. It&#8217;s short, too.</p>
<p>It is a nice extra bit of info but pretty far away from what it&#8217;d take to turn you into a competent twisted developer.</p>
<p>It&#8217;s really too bad, too, b/c from what I can tell twisted is an amazing piece of work, it&#8217;s just well-nigh unapproachable.</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Stephan Schmidt</title>
		<link>http://www.littlehart.net/atthekeyboard/2009/09/14/open-source-is-really-about-documentation/comment-page-1/#comment-13981</link>
		<dc:creator>Stephan Schmidt</dc:creator>
		<pubDate>Wed, 16 Sep 2009 09:56:06 +0000</pubDate>
		<guid isPermaLink="false">http://www.littlehart.net/atthekeyboard/?p=534#comment-13981</guid>
		<description>Good point. Which brings me to Cassandra. Great software, documentation subpar (compared e.g. to something similar: MongoDB which has excellent documentation).

Cheers
Stephan</description>
		<content:encoded><![CDATA[<p>Good point. Which brings me to Cassandra. Great software, documentation subpar (compared e.g. to something similar: MongoDB which has excellent documentation).</p>
<p>Cheers<br />
Stephan</p>
]]></content:encoded>
	</item>
</channel>
</rss>
