These are mostly semi-typographic problems - rather than substantive
technical issues.
1. Chapter 2: the diagrams have users Joe and Jane, but the text has users
Harry and Sally. Figs 2.2, 2.3, 2.4, 2.5 are affected, maybe others.
2. On p13 (last paragraph of 'Revisions' before fig 2.7) - contains 'each
tree is a snap-"shot" of the way' broken across a line at the hyphen. The
double quotes should be around snapshot, not just shot.
3. (Chapter 3 - section 'Revisions: Numbers, Keywords, and Dates, Oh My!';
personally, I'd omit the ", Oh My!", but it you retain it, I think you need
a stronger punctuation than a comma to separate it from what's gone before
- probably a dash or maybe a semi-colon might be appropriate.)
4. Chapter 4: p41 (Section 'Using Branches', second last paragraph before
subsection 'Creating a Branch'): you have 'merge into your working
es-copy--pecially all at once'; I think the problem and fix is obvious once
spotted.
5. Chapter 4: p45-47: on p45, the svn log output for integer.c lists '2
lines' as the changes between revisions 343 (303) and 344, yet the output
from svn diff -r343:344 on p46-47 shows 4 lines changed. This seems to be
a consistency problem.
6. General comment: will you choose to update the 2002 dates to 2003 or
2004 before releasing the book?
7. General comment: should you reference any other works on general SCM?
I'm particularly thinking that novices at CM might benefit from Wayne
Babich's book - "Software Configuration Management: Coordination for Team
Productivity" by Wayne A Babich, Addison-Wesley, 1986, ISBN 0-201-101610-1
(still available from Amazon, maybe; certainly as 'New and Used', though it
is listed as out of print - but still available in 1-2 days?). It's a
general introduction to "Why CM" - extremely good for that. Searching for
"Babich Configuration Management" at Amazon generates a list of books, a
number of which reference Babich.
That's it for now - on chapters 1-4.
--
Jonathan Leffler (jleffler@us.ibm.com)
STSM, Informix Database Engineering, IBM Data Management
4100 Bohannon Drive, Menlo Park, CA 94025
Tel: +1 650-926-6921 Tie-Line: 630-6921
"I don't suffer from insanity; I enjoy every minute of it!"
Received on Wed Feb 4 23:09:09 2004