Re: Time to Reorg the Doc? [Was: HTextArea form element ]

Bill Hefley <weh@oclc.org>
Date: Thu, 30 Jun 94 07:44:12 EDT
Message-id: <199406301139.HAA14151@ts5a.sei.cmu.edu>
Reply-To: html-ig@oclc.org
Originator: html-ig@oclc.org
Sender: html-ig@oclc.org
Precedence: bulk
From: Bill Hefley <weh@oclc.org>
To: Multiple recipients of list <html-ig@oclc.org>
Subject: Re: Time to Reorg the Doc? [Was: HTextArea form element ] 
X-Listprocessor-Version: 6.0c -- ListProcessor by Anastasios Kotsikonas
X-Comment: HTML Implementation Group (Private)

I like the prioritixzation, although there's a place or two where I might
quibble between a 2 and a 3. The only addition that I might suggest making to
Dan's list is to add at the end:

Publication Forums/Audiences:
	* Publication through a widely accessible WWW site 		4
          (especially if an HTML document is being produced)


In Message-Id: <9406292125.AA04373@ulua.hal.com>, "Daniel W. Connolly"
<connolly@oclc.org> writes:

So let's inventory exactly what we require for an HTML 2.0 spec:

I invite folks to rate each of the following as:
	5 - must have this for my purposes
	4 - may have this, and I think it should
	3 - may have this, but I don't care
	2 - may have this, but I'd rather it did not
	1 - must not have this

							Connolly's Rating
Normative content:
	* An SGML Declaration and one or more DTD subsets		5
	* Minimal conformance definition				5
	* Definition of element semantics				5
		(e.g. what rendering distinctions MUST be made)
	* Element reference						4
	* Examples of recommended usage					3
	* Explanation of operation of anchors, forms, ISINDEX, ISMAP	2
	* Explanation of WWW linking and addressing			2
	* Security Issues						2

(if only there were time...)
	* Test Suite							4

Informative content:
	* Publication History						4
	* Summary of Changes since draft-iiir-html-01			4
	* "Typical Rendering" instructions				3
	* Historical notes about browser implementations that		3
		conflict with the SGML standard
	* Examples of common authoring errors				3
	* Rationale behind contentious issues				3
		(e.g. "why P is a container")
	* Proposed language changes					3

Navigation Features and Media:
	* A Postscript format file					5
	* A collection of HTML nodes					4
	* A plain text format file					4
	* A DocBook document						3

	* List of Reviewers						5
	* Revision History						4
	* Numberd Sections						4
	* Title page							3
	* Abstract							3
	* Index								3

Publication Forums/Audiences:
	* Publication through the IETF as an RFC or FYI			4
	* Publication through the Davenport group			3
	* Publication through SGML Open					3

Dan