On Fri, Oct 31, 2008 at 07:11:34PM -0700, Jason Dagit wrote: > On Fri, Oct 31, 2008 at 7:05 PM, Trent W. Buck <[EMAIL PROTECTED]> wrote: > > Christian Kellermann <[EMAIL PROTECTED]> writes: > > > >>> We don't seem to have any hard and fast rules about line length, but > >>> this one does seem overly long. This might be a bit easier for > >>> people: > >> > >> There does not need to me a rule, the above is indeed ugly, agreed. > > > > Perhaps there should be a HACKING file that references some general > > Haskell style guides, and describes any conventions for Darcs code? > > No objections to that. We're currently hashing this document out on the wiki: > http://wiki.darcs.net/DarcsWiki/DeveloperGettingStarted > http://wiki.darcs.net/DarcsWiki/CodingStyle > > And I've asked Eric to kindly update the motd to mention those > documents as well. > > I know you tend to be web browser adverse, but the wiki seems to be > a nice way to collaborate on documentation. So I hope you don't > mind collaborating there...
Sure; I'm prepared to accept increased suck for me in that respect because a wiki is easier for "normal" people. I *would* like it if we had something like ikiwiki providing a wiki interface on top of an easy-for-me-to-use darcs repository full of reST documents, but that isn't production-ready yet (in particular, ikiwiki has no darcs integration and only basic reST integration). I am, however, opposed to moving the user manual onto the wiki, because we lose 1) pretty PDF output; and 2) literate documentation for src/Darcs/Commands/*.lhs. _______________________________________________ darcs-users mailing list [email protected] http://lists.osuosl.org/mailman/listinfo/darcs-users
