git.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: "Ciprian Dorin Craciun" <ciprian.craciun@gmail.com>
To: "Steffen Prohaska" <prohaska@zib.de>
Cc: "Evan Carroll" <me@evancarroll.com>, git@vger.kernel.org
Subject: Re: Announcement of Git wikibook
Date: Sat, 20 Oct 2007 10:40:24 +0300	[thread overview]
Message-ID: <8e04b5820710200040q76301c58j33e5d0895956b150@mail.gmail.com> (raw)
In-Reply-To: <C0D5CAE0-A152-4572-81D5-AF2A78DD89C6@zib.de>

    There is nothing wrong with either of the two approaches. They
could both coexist but address different needs:
    -- the manual should be more oriented on technical issues and
addresses only the most recent versions;
    -- the book should be more user-oriented, and more general,
explaining how source management should be addressed by using git, and
maybe make comparisons with may other versioning systems. Also the
book could relate to many versions -- both old and new.

    Also I would note that the wiki book is more easy to edit... If
you spot errors or want to add something you just go and edit it and
the effect is immediate. But in contrast sending patches involves some
overhead...

    Ciprian.


On 10/19/07, Steffen Prohaska <prohaska@zib.de> wrote:
>
> On Oct 19, 2007, at 10:21 PM, Evan Carroll wrote:
>
> > I've create a git wikibook if anyone wants to help expand it.
> > http://en.wikibooks.org/wiki/Source_Control_Management_With_Git
>
> I'm just curious. What is the advantage of a wikibook?
>
> We already have a manual
>
> http://www.kernel.org/pub/software/scm/git/docs/user-manual.html
>
> including a todo list
>
> http://www.kernel.org/pub/software/scm/git/docs/user-manual.html#todo
>
> So, why don't you send patches improving the manual, but instead
> started a wiki book from scratch?
>
>         Steffen

  reply	other threads:[~2007-10-20  7:40 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2007-10-19 20:21 Announcement of Git wikibook Evan Carroll
2007-10-19 20:58 ` Steffen Prohaska
2007-10-20  7:40   ` Ciprian Dorin Craciun [this message]
2007-10-20 11:20     ` Wincent Colaiuta
2007-10-20 21:34     ` Johannes Schindelin
2007-10-21  3:09       ` Steven Walter
2007-10-21  9:10         ` Wincent Colaiuta
2007-10-21 10:06           ` Steffen Prohaska

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=8e04b5820710200040q76301c58j33e5d0895956b150@mail.gmail.com \
    --to=ciprian.craciun@gmail.com \
    --cc=git@vger.kernel.org \
    --cc=me@evancarroll.com \
    --cc=prohaska@zib.de \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).