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

[C. Michael Pilato]

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
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

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.red-bean.com/pipermail/svnbook-dev/attachments/20130702/a7d219e0/attachment-0001.html>