[PATCH] A working copy is not called a 'repository'
Daniel Shahaf
danielsh at elego.de
Wed Jul 3 06:22:05 CDT 2013
C. Michael Pilato wrote on Tue, Jul 02, 2013 at 21:35:56 -0400:
> On 07/02/2013 05:08 PM, Daniel Shahaf wrote:
> > C. Michael Pilato wrote on Tue, Jul 02, 2013 at 13:59:34 -0400:
> >> I like the idea here, but I think it's being introduced too early. Chapter
> >> 1 introduces concepts in a layered manner. The first section is split into
> >> two subsections, "Version Control Basics" and "Version Control the
> >> Subversion Way". I'd rather see your sidebar in the latter subsection, when
> >> it's more "okay" to talk about Subversion specifically. (But I'll grant
> > Okay. So how about moving the sidebar to the very end of
> > http://svnbook.red-bean.com/nightly/en/svn.basic.in-action.html#svn.basic.in-action.wc
> > ? Should I send a new patch?
>
> Nah. If you're okay with my moving it, I'll just add your sidebar in the
> new location.
>
+1
> > BTW, I considered also adding a clarification about "^/project and
> > ^/project/trunk are not called a 'repository', either", but decided
> > against it.
>
> Yeah, there's a certainly level of clue that the book expects. There will
> always be edge cases in the readership of folks who cling to some bit of
> false knowledge (unwittingly or otherwise). We can't possible address all
> such instances.
True, but my logic was different: the confusion stemming from
a non-server-admin referring to ^/subversion as a repository would be
minimal (indeed, whether /repos or /repos/asf or /repos/asf/subversion
is the repository root can be considered an implementation detail, from
the user's perspective), and a server admin would presumably know
better (at least, once he crosses the 'Why doesn't `ls /srv/repos/calc`
show a 'trunk' dir?' stage).
More information about the svnbook-dev
mailing list