[svnbook commit] r2657 - trunk/src/en/book

C. Michael Pilato cmpilato at red-bean.com
Tue Feb 6 09:57:51 CST 2007


Ben Collins-Sussman wrote:
> On 2/5/07, cmpilato <noreply at red-bean.com> wrote:
> 
>> * src/en/book/ch-advanced-topics.xml
>>   (Network Model): Rework to be ... Pilatoan, and revert the changes
>>     to the section IDs made when moving this section from the Server
>>     Configuration chapter.  (It was rather the point of using such IDs
>>     to allow us to move sections around without breaking URLs in our
>>     HTML forms of the book.)
> 
> So uh, yeah, we *could* move sections around without breaking
> things... which is nice.   But if it's trivial to rename them, why not
> do so?  I only had to tweak 3 references.  Isn't that better?  Does it
> really make sense to have a bunch of sections named "svn.serverconfig"
> in a chapter full of "svn.advanced" sections?
> 
> I have no sympathy for people making permalinks to a moving-target
> nightly build of the book's trunk.  Ayita can eat my shorts.

But.  But.  But.  But it was *the very reason* we did that whole ID renaming
 thing, I thought!

>> +      networking layer is abstracted, meaning that Subversion clients
>> +      exhibit the same general behaviors no matter what sort of server
>> +      they are operating against.  Whether speaking the HTTP protocol
>> +      (<literal>http://</literal>) with the Apache HTTP Server or
>> +      speaking the custom Subversion protocol
>> +      (<literal>svn://</literal>) with <command>svnserve</command>,
>> +      the basic network model is the same.  In this section, we'll
>> +      explain the basics of that network model, including how
>> +      Subversion manages authentication and authorization
>> +      matters.</para>
> 
> So, um, this section only talks about how authentication works, and
> how client-side credential caching works.  Authorization isn't part of
> it at all.
> 
> Also, I think it's a tad awkward to say "the basic network model", and
> then in the next immediate sentence say "the basics of that network
> model".  Too repetitive.

Noted.

-- 
C. Michael Pilato <cmpilato at red-bean.com>

"The Christian ideal has not been tried and found wanting.  It has
 been found difficult; and left untried."  -- G. K. Chesterton




More information about the svnbook-dev mailing list