I like either idea, though of course I lean towards not duplicating
information that's already maintained elsewhere unless, of course, there's
reason to believe that it *won't* be maintained elsewhere.
Just for kicks, I did some Googling around:
- "Subversion cheat sheet": returns a number of third-party (largely
PDF) resources
- "Subversion quick start": the project's quick-start page wins the
day, with the Book's "High-Speed Tutorial" second
- "getting started with Subversion": the project's quick-start page
again is the top hit, with the book nearly not even making the top-10 hits
So, yeah, I think linking from http://subversion.apache.org/quick-start is
a wise move.
-- Mike
On Fri, Aug 25, 2017 at 7:03 AM, Johan Corveleyn <jcorvel_at_gmail.com> wrote:
> [ 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_at_red-bean.com> wrote:
> > On Thu, Jul 13, 2017 at 11:21 AM, Daniel Shahaf <d.s_at_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
>
Received on 2017-08-25 20:26:21 CEST