[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