[projectaon] Re: Highway Holocaust XML Changes

  • From: Jonathan Blake <blake.jon@xxxxxxxxx>
  • To: projectaon@xxxxxxxxxxxxx
  • Date: Wed, 7 Dec 2005 12:48:12 -0800

On 12/7/05, Iain Smith <iainsmith@xxxxxxxxx> wrote:
> Jon,
> I've checked the diff list between your version of 01HH and my previous 
> version.  Most of
> the changes are straightforward and can be implemented in the remaining books 
> easy
> enough.  A couple of concerns though:
>
> Replaced "pick a O" with "pick a 0"
> I my copies of each of the FW books, the original text definitely has this 
> down as a
> capital "O" rather than the number zero.  This only really stands out because 
> there are
> o's and zeros nearby.  I'm not sure if it really needs to be errata though, 
> it's only a
> relatively minor change.

The idea behind the errata list is that I should be able to
reconstruct the original edition from the list. Granted that isn't
strictly true with how we have it, but that is the idea.

> Tables:
> Is everyone happy with using the HTML table tags in the XML source?  I would 
> have thought
> that a more flexible approach would be to use generic terms in the XML and 
> replace these
> with HTML tags in the XSL file.  Just a thought, I'll be fine with it if 
> everyone else is
> happy.

In what ways would you like it to be more generic? The only reason
that we have it this way is because it has been suitable to our needs
so far. Making it look like HTML serves two purposes: primarily to
make it easy to remember for all the HTML monkeys (including myself)
who work on it, and to make the translation to HTML via XSL more
straightforward.

> Character Entities:
> I'll go ahead and replace these in the XML of the other books as I find 
> instances.

Good work on this, BTW. I used to have a utility to find non-ASCII
characters in the source. I wonder where it's gotten to. Should be
able to use grep though.

> Lost Changes:
> In your version of the XML it seems that some of the fixes I applied to the 
> previous
> version have been undone.  Namely the paragraphs in the survival skills 
> section and the
> misplaced periods in the Errata section.  I'll reintroduce these fixes into 
> my current
> version of the file and check that they get back in the next time I submit 
> changes.

I haven't had much experience with the web CVS interface. I hope that
it allows you to merge changes and resolve version conflicts. That's
the whole point of CVS, after all. :)

> I've built up a list of pending concerns that I have, I'll hopefully get them 
> posted
> later today so that we can have a good-old argument about them.  I've still 
> not tackled
> and grammar issues, since my grammar leaves a lot to be desired. :)

Those are the issues that really should be discussed prior to changes.

--
Jon

Other related posts: