Re: [doc] User Manual Suggestion

From: Jeff King <peff@peff.net>
Date: Apr 24, 2009, 18:27 UTC
Message-ID: <20090424182752.GC11360@coredump.intra.peff.net>
In-Reply-To: <20090424173852.GF17365@fieldses.org>

On Fri, Apr 24, 2009 at 01:38:52PM -0400, J. Bruce Fields wrote:

Show 17 quoted lines

> On Fri, Apr 24, 2009 at 10:18:15AM -0500, Michael Witten wrote:
> > I think that we've already got that tutorial-esque style covered (I
> > haven't read it in a while):
> > 
> >     http://www.kernel.org/pub/software/scm/git/docs/gittutorial.html
> > 
> > However, the User Manual should make a Mathematician happy.
> 
> I'm all for making mathematicians happy.  But, again, help?:
> 
> 	- Specific examples?
> 	- Patches?  Please, patches?
> 	- Suggested text?
> 	- Suggested outline?
> 
> There's no shortage of high-level ideas.  What there's always a need for
> more of is people willing to submit patches, respond to review, etc.

I usually hate to "me too", but I really want to second this notion. We have been getting minor documentation fixups trickling in, and I think those really help, and maybe they eventually would make the documentation perfect. But I have the feeling we would benefit from somebody taking ownership and considering the big picture of how the documentation fits together, and then really pushing it forward with something concrete.

-Peff