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

Fwd: What's going on with svnbook?

From: Ben Collins-Sussman <sussman_at_red-bean.com>
Date: 2007-01-04 04:12:36 CET

Subversion developers, you'd want to read this mail too:

---------- Forwarded message ----------
From: C. Michael Pilato <cmpilato@red-bean.com>
Date: Jan 3, 2007 3:30 PM
Subject: What's going on with svnbook?
To: Subversion Book Development <svnbook-dev@red-bean.com>

O'Reilly has agreed to print a second edition of Version Control with
Subversion, so Ben, Fitz, and I are in the process of catching up on
some lost time and Subversion version coverage. As part of the planning
effort for this second edition, we took the opportunity to analyze the
structure and content of the first edition. Besides some some minor
policy and voicing changes we agreed to make, we decided:

   * some section reorganization was in order. Even as the primary
     authors, we were finding the book to be a bit of a spaghetti-
     like mess of cross-references and chapter-jumping.

   * to rename the actual source files in use, because names like
     'ch-basic-usage.xml' say so much more than 'ch-01.xml'.

   * to hop off of DocBook Lite, and use the full DocBook 4.4 DTD
     (which is the latest recommendation by O'Reilly).

In order to keep the disruption of trunk to a minimum, we did all the
renaming and reorganization off on a branch. We also did the DocBook
4.4 cutover, just to see what kind of pain it was going to cause us.
(Turned out to be no big deal.) Now that that is all done, we've
"merged" the work back to the trunk. (I say "merged", but what I really
did was replace trunk/src/en with the branch's src/en directory -- keeps
the history cleaner.)

Over the next few months, you should expect to see many changes to the
book sources as we try to bring the information from covering almost-1.3
to fully 1.4, and possibly 1.5 if it happens to get released in time.
You might see broken builds; incomplete thoughts; lots of "### TODO"
comments spread about; etc. We appreciate your patience. And even
more, we appreciate your feedback.

Thanks.

--
C. Michael Pilato <cmpilato@red-bean.com>
"The Christian ideal has not been tried and found wanting.  It has
 been found difficult; and left untried."  -- G. K. Chesterton
_______________________________________________
svnbook-dev mailing list
svnbook-dev@red-bean.com
http://www.red-bean.com/mailman/listinfo/svnbook-dev


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org

Received on Thu Jan 4 04:12:52 2007

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