Mailing-List: contact dev-help@subversion.apache.org; run by ezmlm
Precedence: bulk
MIME-Version: 1.0
In-Reply-To: <CABUQHU6KG0NE+f7QCuuJti7ghHOrRkoX+xaCV3zFU+QFFf42bg@mail.gmail.com>
References: <1498814128.3534340.1026263488.753C51DA@webmail.messagingengine.com>
 <1499959268.1089310.1039851440.28828B3F@webmail.messagingengine.com> <CABUQHU6KG0NE+f7QCuuJti7ghHOrRkoX+xaCV3zFU+QFFf42bg@mail.gmail.com>
From: Johan Corveleyn <jcorvel@gmail.com>
Date: Fri, 25 Aug 2017 13:03:58 +0200
Message-ID: <CAB84uBVSydLh7wrvS65XNg-i70wdp+L+_ry8ud8WUTVunHy=Wg@mail.gmail.com>
Subject: Re: Tip of the day: Cheatsheet for common cmdline client operations
To: Subversion Development <dev@subversion.apache.org>
Cc: Daniel Shahaf <d.s@daniel.shahaf.name>, "C. Michael Pilato" <cmpilato@red-bean.com>
Content-Type: text/plain; charset="UTF-8"
archived-at: Fri, 25 Aug 2017 11:06:58 -0000

[ cc -= svnbook-dev, as I guess this will not become book-material.
More below ... ]

On Thu, Jul 13, 2017 at 6:34 PM, C. Michael Pilato
<cmpilato@red-bean.com> wrote:
> On Thu, Jul 13, 2017 at 11:21 AM, Daniel Shahaf <d.s@daniel.shahaf.name>
> wrote:
>>
>> [moving from users@ ]
>>
>> Daniel Shahaf wrote on Fri, 30 Jun 2017 09:15 +0000:
>> > I just ran into the following cheatsheet:
>> >
>> > http://www.chim.unifi.it/~signo/did/etc/subversion/neat.html
>> >
>> > It covers the normal multi-user workflow, branching, etc..
>> >
>> > (Kudos to the author, Giorgio Signorini, not to me.)
>>
>> As some of you know, the author gave us permission to incorporate that
>> cheatsheet into the official documentation.  Any volunteers to start the
>> process?
>>
>> Cheers,
>>
>> Daniel
>>
> With respect to the author and the work he's done, I'm not really interested
> in us maintaining yet another collection of the same information already
> covered -- in some cases multiple times, when you factor in the reference
> sections -- by the book.  At best this cheatsheet would be an appendix.  I'm
> happy to link to the cheatsheet from from the book website, though.
>
> -- Mike

FWIW, I think this cheatsheet is quite good and valuable (though I
agree there is a lot of overlap with existing documentation),
especially for newcomers. Just to have a good summary / reminder of
common things you'll encounter.

We have our own quickstart page: http://subversion.apache.org/quick-start

How about:

- Putting a link at the bottom of that page (there is already a link
to the quickstart section of the book), linking to the original
webpage of the author.

or

- Incorporating (some of) the content of that cheatsheet directly on
http://subversion.apache.org/quick-start, so it's right there in front
of you ...


The latter option would be my personal preference (putting my user /
admin hat on) -- I like having short info right in front of me in the
right place -- but obviously imposes some amount of doc-maintenance
work on "us".

Maybe someone on this list would be willing to take this doc-task
(migrating the current content, and keep an eye on keeping it up to
date)?

-- 
Johan