From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jeff King Subject: Re: [doc] User Manual Suggestion Date: Fri, 24 Apr 2009 14:27:52 -0400 Message-ID: <20090424182752.GC11360@coredump.intra.peff.net> References: <20090423175717.GA30198@fieldses.org> <20090423201636.GD3056@coredump.intra.peff.net> <20090424141139.GC10761@coredump.intra.peff.net> <20090424150442.GA11245@coredump.intra.peff.net> <20090424173852.GF17365@fieldses.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Cc: Michael Witten , David Abrahams , git@vger.kernel.org To: "J. Bruce Fields" X-From: git-owner@vger.kernel.org Fri Apr 24 20:29:50 2009 Return-path: Envelope-to: gcvg-git-2@gmane.org Received: from vger.kernel.org ([209.132.176.167]) by lo.gmane.org with esmtp (Exim 4.50) id 1LxQ9Z-0003U4-0D for gcvg-git-2@gmane.org; Fri, 24 Apr 2009 20:29:37 +0200 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753682AbZDXS2B (ORCPT ); Fri, 24 Apr 2009 14:28:01 -0400 Received: (majordomo@vger.kernel.org) by vger.kernel.org id S1753176AbZDXS2B (ORCPT ); Fri, 24 Apr 2009 14:28:01 -0400 Received: from peff.net ([208.65.91.99]:59404 "EHLO peff.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752974AbZDXS2A (ORCPT ); Fri, 24 Apr 2009 14:28:00 -0400 Received: (qmail 30571 invoked by uid 107); 24 Apr 2009 18:28:10 -0000 Received: from coredump.intra.peff.net (HELO coredump.intra.peff.net) (10.0.0.2) by peff.net (qpsmtpd/0.40) with (AES128-SHA encrypted) SMTP; Fri, 24 Apr 2009 14:28:10 -0400 Received: by coredump.intra.peff.net (sSMTP sendmail emulation); Fri, 24 Apr 2009 14:27:52 -0400 Content-Disposition: inline In-Reply-To: <20090424173852.GF17365@fieldses.org> Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Archived-At: On Fri, Apr 24, 2009 at 01:38:52PM -0400, J. Bruce Fields wrote: > 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