I&#39;m torn on this one. I&#39;m not going to bother retroactively doing documentation for 0.0.0; however, once I release 0.2.0, and I work on 0.4.0, I&#39;d like people to have access to documentation on released code as well as development code. I&#39;m not quite certain...<div>
<br></div><div>As far as that intro page, I was providing that table more as a comparison, but I think I&#39;ll be removing it entirely.</div><div><br></div><div>Michael<br><br><div class="gmail_quote">On Tue, Apr 13, 2010 at 1:18 PM, Thomas Hartman <span dir="ltr">&lt;<a href="mailto:thomashartman1@googlemail.com">thomashartman1@googlemail.com</a>&gt;</span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">It looks great.<br>
<br>
My only possible nit is that it seems odd to include docu for 0.0.0 as<br>
well as 0.0.2, why not just do the latest and let the past be done?<br>
<div><div></div><div class="h5"><br>
On Tue, Apr 13, 2010 at 12:54 PM, Michael Snoyman &lt;<a href="mailto:michael@snoyman.com">michael@snoyman.com</a>&gt; wrote:<br>
&gt;<br>
&gt;<br>
&gt; On Fri, Apr 9, 2010 at 8:06 AM, Michael Snoyman &lt;<a href="mailto:michael@snoyman.com">michael@snoyman.com</a>&gt; wrote:<br>
&gt;&gt;<br>
&gt;&gt;<br>
&gt;&gt; On Fri, Apr 9, 2010 at 3:32 AM, Gour &lt;<a href="mailto:gour@gour-nitai.com">gour@gour-nitai.com</a>&gt; wrote:<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt; On Fri, 9 Apr 2010 08:36:51 +0200<br>
&gt;&gt;&gt; &gt;&gt;&gt;&gt;&gt;&gt; &quot;Simon&quot; == Simon Hengel wrote:<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt; Simon&gt; My feeling is that we lack mostly short, tutorial-style<br>
&gt;&gt;&gt; Simon&gt; introductions, that just get you started with a topic/library.<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt; I agree.<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt; Moreover, practically every &#39;framework&#39; (except Happs) is more or less<br>
&gt;&gt;&gt; one-man show band, i.e. it works for their authors without docs, but<br>
&gt;&gt;&gt; that&#39;s not the way one can build community around it...And without<br>
&gt;&gt;&gt; some &#39;critical&#39; mass of users, one is reluctant to invest time/energy<br>
&gt;&gt;&gt; into such products...Kind a catch-22. :-(<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt;<br>
&gt;&gt; I can&#39;t speak for others, but I personally don&#39;t have a problem investing<br>
&gt;&gt; in documentation on my one-man-show libraries. In the specific case of<br>
&gt;&gt; Yesod, I *know* it&#39;s going to have some major changes in the next release,<br>
&gt;&gt; so it&#39;s not worth it right now.<br>
&gt;&gt; In general, I think the problem for library writers is that- since *we*<br>
&gt;&gt; wrote the code- we don&#39;t know what&#39;s confusing about it. As far as we&#39;re<br>
&gt;&gt; concerned, our code is beautiful, elegant, simple and self-documenting<br>
&gt;&gt; (until we look at it again six months later). We really need an outside<br>
&gt;&gt; voice to tell us what&#39;s lacking.<br>
&gt;&gt; So instead of saying &quot;fizzbuzz has no documentation,&quot; maybe say &quot;I saw the<br>
&gt;&gt; fizzbuzz tutorial on creating foobars, but I couldn&#39;t figure out how to<br>
&gt;&gt; extend that for wibbles. Could you write a tutorial for that?&quot;<br>
&gt;&gt;<br>
&gt; So I finally decided to start on the documentation front. Thanks to everyone<br>
&gt; who&#39;s kicked me to get it done, and thanks in particular to Gour for<br>
&gt; reviewing some of it for me. I&#39;ll be placing on Yesod-related documentation<br>
&gt; on a new site:<br>
&gt; <a href="http://docs.yesodweb.com/" target="_blank">http://docs.yesodweb.com/</a><br>
&gt; I&#39;m using Hakyll to generate the site, which is working very nicely. The<br>
&gt; code is all available on github (<a href="http://github.com/snoyberg/yesoddocs" target="_blank">http://github.com/snoyberg/yesoddocs</a>), so<br>
&gt; if anyone wants to make changes, you can either e-mail me or send a patch.<br>
&gt; It&#39;s not *quite* as nice as a wiki for collaboration, but hopefully will be<br>
&gt; easier to follow.<br>
&gt; Next goal will be to put up docs on web-routes-quasi.<br>
&gt; Michael<br>
</div></div><div><div></div><div class="h5">&gt; _______________________________________________<br>
&gt; web-devel mailing list<br>
&gt; <a href="mailto:web-devel@haskell.org">web-devel@haskell.org</a><br>
&gt; <a href="http://www.haskell.org/mailman/listinfo/web-devel" target="_blank">http://www.haskell.org/mailman/listinfo/web-devel</a><br>
&gt;<br>
&gt;<br>
<br>
<br>
<br>
--<br>
Need somewhere to put your code? <a href="http://patch-tag.com" target="_blank">http://patch-tag.com</a><br>
Want to build a webapp? <a href="http://happstack.com" target="_blank">http://happstack.com</a><br>
</div></div></blockquote></div><br></div>