[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

Re: one more example of unclear terminology in SVN book

From: Ben Collins-Sussman <sussman_at_collab.net>
Date: 2004-12-19 21:36:03 CET

On Dec 19, 2004, at 1:55 PM, Robert P. J. Day wrote:

> On Sun, 19 Dec 2004, Ben Collins-Sussman wrote:
>> On Dec 19, 2004, at 11:16 AM, Robert P. J. Day wrote:
>>> first, are we doing a "checkout of your project" or are we
>>> "Checking
>>> out a repository"? does a repo contain one project, or possibly
>>> multiple projects?
>> Chapter 3 is written for users trying to learn the commandline
>> client, and it assumes an administrator has already "set up" a
>> project for them to check out. It's not important whether there are
>> N projects in 1 repository, or N separate repositories. It's not
>> important what part of the URL represents the repository itself.
>> These issues are only important to administrators setting things up.
>> All that matters is that an administrator has given the user a URL
>> to "check out", and that's what this chapter is assuming. Perhaps
>> chapter 3 should state that explicitly? Would that make things
>> clearer?
> even for a simple example like this, i still think it's critically
> important to use terminology consistently. should the beginning user
> think he's checking out a repository? or a project in a repository?
> yes, there's a difference. you initialize a repo with "svnadmin
> create". you don't do the same for a "project", so to constantly
> interchange the two words is, fer shure, going to confuse at least a
> few people.

Hm, okay. Perhaps we should exise the word 'project' from all of the
early chapters. Subversion has no concept of 'project' at all, just
directories. Perhaps we should just standardize on the phrase "check
out part of a repository".

Thanks for the feedback!

To unsubscribe, e-mail: users-unsubscribe@subversion.tigris.org
For additional commands, e-mail: users-help@subversion.tigris.org
Received on Sun Dec 19 21:38:24 2004

This is an archived mail posted to the Subversion Users mailing list.

This site is subject to the Apache Privacy Policy and the Apache Public Forum Archive Policy.