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