<html>
<head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
</head>
<body bgcolor="#FFFFFF" text="#000000">
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 <i>centralized</i>
version control systems.)<br>
<br>
<div class="moz-cite-prefix">On 07/01/2013 03:59 PM, Daniel Shahaf
wrote:<br>
</div>
<blockquote cite="mid:20130701195932.GC2976@lp-shahaf.local"
type="cite">
<pre wrap="">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
<a class="moz-txt-link-abbreviated" href="mailto:svnbook-dev@red-bean.com">svnbook-dev@red-bean.com</a>
<a class="moz-txt-link-freetext" href="http://www.red-bean.com/mailman/listinfo/svnbook-dev">http://www.red-bean.com/mailman/listinfo/svnbook-dev</a>
</pre>
</blockquote>
<br>
</body>
</html>