[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: Robert P. J. Day <rpjday_at_mindspring.com>
Date: 2004-12-19 20:55:37 CET

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.

rday

---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@subversion.tigris.org
For additional commands, e-mail: users-help@subversion.tigris.org
Received on Sun Dec 19 20:58:38 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.