[PATCH] A working copy is not called a 'repository'

Daniel Shahaf danielsh at elego.de
Tue Jul 2 16:08:19 CDT 2013


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?

BTW, I considered also adding a clarification about "^/project and
^/project/trunk are not called a 'repository', either", but decided
against it.

Daniel

> also that the former subsection may need to specifically note that the terms
> it introduces are being introduced in the context of /centralized/ version
> control systems.)
> 
> On 07/01/2013 03:59 PM, Daniel Shahaf wrote:
> > Trying to root out new users' tendency to call a wc a repos, or, more
> > realistically, to have something to link them to when they make that
> > mistake.
> >
> > The last sentence could use some wordsmithing to avoid letting the
> > reader infer that confusion is common.  What I mean to say is that new
> > users often use the wrong term, not that "which term should I use?" is
> > a common question among experienced users.
> >
> > [[[
> > * ch01-fundamental-concepts.xml
> >   (svn.basic.working-copy.sb-repository-term): New sidebar.
> > ]]]
> >
> > Index: ch01-fundamental-concepts.xml
> > ===================================================================
> > --- ch01-fundamental-concepts.xml	(revision 4515)
> > +++ ch01-fundamental-concepts.xml	(working copy)
> > @@ -131,6 +131,21 @@
> >          its contents to and from the repository falls squarely to the
> >          version control system's client software.</para>
> >  
> > +        <sidebar id="svn.basic.working-copy.sb-repository-term">
> > +          <title>A Working Copy is not called a "Repository"</title>
> > +
> > +          <para>In Subversion, the object which every user of the system
> > +            has—the collection of versioned files, along with metadata
> > +            that enables the system to track them and communicate with the
> > +            server—is called a <emphasis>working copy</emphasis>, and
> > +            the server-side object is called a
> > +            <emphasis>repository</emphasis>.  Although other version control
> > +            systems use the term "repository" for the client-side object,
> > +            using the term "repository" that way in Subversion context is wrong
> > +            and a common source of confusion.</para>
> > +
> > +        </sidebar>
> > +
> >      </sect2>
> >  
> >      <!-- =============================================================== -->
> >
> > _______________________________________________
> > svnbook-dev mailing list
> > svnbook-dev at red-bean.com
> > http://www.red-bean.com/mailman/listinfo/svnbook-dev
> 




More information about the svnbook-dev mailing list