Re: Effective ways to comment on the HTML 2.0 spec

"Daniel W. Connolly" <connolly@hal.com>
Message-id: <9406101628.AA07879@ulua.hal.com>
To: html-ig@oclc.org
Subject: Re: Effective ways to comment on the HTML 2.0 spec 
In-reply-to: Your message of "Fri, 10 Jun 1994 12:19:14 EDT."
             <199406101614.JAA23243@rock> 
Date: Fri, 10 Jun 1994 11:28:50 -0500
From: "Daniel W. Connolly" <connolly@hal.com>
Content-Length: 1192
In message <199406101614.JAA23243@rock>, Terry Allen writes:
>You're still missing the point, Dan.  If I want to show original
>and replacement text within the HTML format, how should I do it?

There is no way to express in HTML "this text ... has changed."

There are proposals for changebars etc, but not in 2.0.

>or should I just provide a new version in HTML?

Yes. Just send the replacement or diffs. Send comments in some
out-of-band way. Your mail message with a comment about the
HTML gloss and the replacement for HTML.html is perfect.

[though if you'd attached the HTML.html in MIME format,
it would make things slightly easier for me... you guys
have ZMail: why don't you use it?]

I use CVS to manage the source of the document. I just drop
your replacement in, check it in, and use your comments as
the checkin comments. The collection of all such comments
is available at:

	http://www.hal.com/%7Econnolly/html-spec/ChangeLog

Ah... one trick is that I have to determine which version
your comments apply to. I need to stick $Id$ in all the
html files to track this sort of thing. I had it in there
at one point, but Tim's NeXT editor loses comments when
it edits stuff.

Dan