Return-Path: Mailing-List: contact forrest-dev-help@xml.apache.org; run by ezmlm Delivered-To: mailing list forrest-dev@xml.apache.org Received: (qmail 70020 invoked from network); 19 May 2002 13:03:40 -0000 Received: from smtpout.mac.com (204.179.120.86) by daedalus.apache.org with SMTP; 19 May 2002 13:03:40 -0000 Received: from smtp-relay04-en1.mac.com (smtp-relay04-en1 [10.13.10.223]) by smtpout.mac.com (8.12.1/8.10.2/1.0) with ESMTP id g4JD3gEM011426 for ; Sun, 19 May 2002 06:03:42 -0700 (PDT) Received: from asmtp02.mac.com (asmtp02-qfe3.mac.com [10.13.10.66]) by smtp-relay04-en1.mac.com (8.12.1/8.12.1/1.0) with ESMTP id g4JD3b2J016516 for ; Sun, 19 May 2002 06:03:37 -0700 (PDT) Received: from localhost ([216.114.163.224]) by asmtp02.mac.com (Netscape Messaging Server 4.15) with ESMTP id GWD09X00.U9S for ; Sun, 19 May 2002 06:03:33 -0700 Date: Sun, 19 May 2002 09:05:59 -0400 Subject: Re: Remodularized DTDs Content-Type: multipart/mixed; boundary=Apple-Mail-1-556687084 Mime-Version: 1.0 (Apple Message framework v472) From: Diana Shannon To: forrest-dev@xml.apache.org In-Reply-To: <200205190610.g4J6ATwj005889@smtpin06.mac.com> Message-Id: <2A393F54-6B29-11D6-BA26-0030653FE818@mac.com> X-Mailer: Apple Mail (2.472) X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N --Apple-Mail-1-556687084 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset=US-ASCII; format=flowed Many thanks, Steven and David, for the constructive feedback and modifications. Based on your input, I now submit my own modifications. 1. Moved overview content to header/abstract As Steven suggested, and upon further reflection, I agree that it was redundant. Better to encourage authors to include overview content through instructions, example, and templates than to enforce it via DTD (which provides weak enforcement, at best). 2. Moved overview/note (introduced by David) to header/notice. 3. Removed revisions Based on earlier Forrest thread. Revisions will stand on their own (separate revision dtd or document dtd) with hooks (via id or filename) to document. This will facilitate patch application (i.e. no substantive review required as revision content is simply added to existing doc content). 4. Made audience/purpose/prerequisites optional Again, better to encourage authors to include content through instructions, example, and templates than to enforce it via DTD. 5. Corrected spelling mistake, prerequisites 6. Versioning Steven also asked me to propose some content for a versioning system (draft, release, revision or numbers). I have nothing to propose because I see no use for it at the present time given our distributed CMS model. Rather than use some rather subjective and lagging indicator of a document's relevancy, we should use community patches (in the form of revision docs with dates) to communicate document status. IMO, associating status with version numbers will only mislead readers. Extension Seems to me we should consider reusing this dtd (with a more generic name) for other community submissions. For example, tutorial and code snippet will be the same, except for the element "steps." Perhaps we can use a more generic term for "steps," such as "contribution" or "core" or similar... Diana --Apple-Mail-1-556687084 Content-Disposition: attachment; filename=howto-samples-rev.tar.gz Content-Transfer-Encoding: base64 Content-Type: application/x-gzip; x-unix-mode=0644; name="howto-samples-rev.tar.gz" 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 NKMZzWhGM5rRjGY0439l/Af6b1g6AFAAAA== --Apple-Mail-1-556687084 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset=US-ASCII; format=flowed --Apple-Mail-1-556687084--