RE: [dita] Errata information added to home page

["Mary McRae" <mary.mcrae@oasis-open.org>]

Hi Don,

  There wouldn't be an Errata "page" (as in a home page or index page);
there would be an Errata document that would use the same template as a
specification (might be easier to prepare in OpenOffice or Word or even in
straight XHTML than in DITA) that would be identified as DITA v1.1 Errata -
Committee Draft 01 - [approval date] and would have a "latest version" URI
of something like docs.oasis-open.org/dita/v1.1/errata/dita-v1.1-errata.html
and a specific version of something like
docs.oasis-open.org/dita/v1.1/errata/dita-v1.1-errata-cd01.html, etc.

WebCGM has an errata for a DTD error; Security Services has a single errata
document that combines multiple documents.

WebCGM: http://docs.oasis-open.org/webcgm/v2.0/errata/
You'll see two symlinks pointing to the latest version; and a directory for
the cd and os-specific versions of the errata.

Security Services:
http://docs.oasis-open.org/security/saml/v2.0/sstc-saml-approved-errata-2.0-
cd-02.html
Note that it doesn't make proper use of the "latest version" URI but shows
how to combine errata from multiple documents into a single file.

Does that help? 

Mary


> -----Original Message-----
> From: Don Day [mailto:dond@us.ibm.com]
> Sent: Wednesday, September 05, 2007 3:55 PM
> To: mary.mcrae@oasis-open.org
> Cc: dita@lists.oasis-open.org; Mary McRae; 'Grosso, Paul'
> Subject: RE: [dita] Errata information added to home page
> 
> Thanks for those suggestions, Mary. I have some practical questions
> coming
> out of this discussion.  It is still not clear to me where such an
> Errata
> page itself would be posted. Would it also be at docs.oasis-
> open.org/dita/?
> Is there a suggested template to follow for its look and feel? Would I
> need
> to ask you to replace the document at that location as we provide new
> CD
> file updates?
> 
> Regards,
> --
> Don Day
> Chair, OASIS DITA Technical Committee
> IBM Lead DITA Architect
> Email: dond@us.ibm.com
> 11501 Burnet Rd. MS9033E015, Austin TX 78758
> Phone: +1 512-838-8550
> T/L: 678-8550
> 
> "Where is the wisdom we have lost in knowledge?
>  Where is the knowledge we have lost in information?"
>    --T.S. Eliot
> 
> 
> 
>              "Mary McRae"
>              <mary.mcrae@oasis
>              -open.org>
> To
>              Sent by: Mary             "'Grosso, Paul'"
> <pgrosso@ptc.com>,
>              McRae                     <dita@lists.oasis-open.org>
>              <marypmcrae@gmail
> cc
>              .com>
> 
> Subject
>                                        RE: [dita] Errata information
> added
>              09/04/2007 04:07          to home page
>              PM
> 
> 
>              Please respond to
>              <mary.mcrae@oasis
>                 -open.org>
> 
> 
> 
> 
> 
> 
> Hi Paul,
> 
> > -----Original Message-----
> > From: Grosso, Paul [mailto:pgrosso@ptc.com]
> > Sent: Tuesday, September 04, 2007 3:50 PM
> > To: dita@lists.oasis-open.org
> > Subject: RE: [dita] Errata information added to home page
> >
> [Mary: ] [stripped text]
> >
> > If I understand, we could produce an "Errata" document (explaining
> > that these are "resolved issues" but not yet official errata) and
> > get that put at some reasonable URL on the OASIS site.  Then we
> > could augment the content of that document (without changing its
> > URL) as we find and resolve more issues.  Is that correct?
> 
> [Mary: ] Yes. We could use something like
> docs.oasis-open.org/dita/v1.1/errata/ and then have version-specific
> filenames (dita-v1.1-errata-cd01) with a current version name of
> dita-v1.1-errata or similar.
> 
> Who
> > would have permission to augment that document?
> 
>  [Mary: ] The TC would maintain the document like any other. At each
> point
> a
> new set of changes is approved the status would go from CD 01 to CD 02
> (with
> interim CD01 R01, R02, etc. until approval). Each time a new CD is
> created
> send it to me and I'll upload (at least until the OASIS Library is at a
> point where members can self-serve).
> 
> >
> > Something like that would seem to me to be most beneficial to
> > our user and implementor community and most manageable by the TC.
> >
> 
> [Mary: ] +1
> 
> > paul
> >
> > >
> > >   I'm ready and willing to help - I just need to know exactly
> > > how the TC
> > > wants to proceed.
> > >
> > > Regards,
> > >
> > > Mary
> > >
> > > -----Original Message-----
> > > From: Grosso, Paul [mailto:pgrosso@ptc.com]
> > > Sent: Tuesday, September 04, 2007 1:42 PM
> > > To: dita@lists.oasis-open.org
> > > Subject: RE: [dita] Errata information added to home page
> > >
> > >
> > >
> > > > -----Original Message-----
> > > > From: Robert D Anderson [mailto:robander@us.ibm.com]
> > > > Sent: Tuesday, 2007 September 04 12:19
> > > > To: dita@lists.oasis-open.org
> > > > Subject: RE: [dita] Errata information added to home page
> > > >
> > > > "Grosso, Paul" <pgrosso@ptc.com> wrote on 09/04/2007 12:11:57 PM:
> > > > > However, it would be best to have a separate "Errata for DITA
> > 1.1"
> > > > > page that could be linked to from this location on our
> > > main TC page.
> > > >
> > > > I agree - I asked Don about setting up another page at the
> > > > TC, but it looks
> > > > like the only way to add pages to the main Committee page is
> > > > by uploading a
> > > > document or by sending an email. In that case it won't really be
> a
> > > > permanent Errata page. One alternative was to point to a page
> > > > on our Wiki,
> > > > but (to me) that seemed rather too unofficial. If somebody
> > > > has a suggestion
> > > > of how to get a more official looking errata page at the TC,
> > > > please speak
> > > > up... alternatively, if others think a wiki page is
> > > > appropriate, we could just do that.
> > >
> > > <rant>The OASIS Kavi system has many disadvantages, and some of
> > > us have been complaining about them for years.  Unfortunately,
> > > either we are in the minority or we have been ignored.  The
> > > problems, such as this, remain.  We still don't really have
> > > a web site, just a web-dispensed data base.  I hate it.</rant>
> > >
> > > Maybe Mary can suggest a way we can have a real Errata page
> > > to which we can point and which we can update as necessary.
> > >
> > > >
> > > > > By the way, are the links into our mailing list and document
> > > > > archive member-only, or do they work for others?
> > > >
> > > > The links from the TC page are for anybody. The internal
> > > links within
> > > > Eric's email are member only, because that's what the
> > > upload-document
> > > > function generates.
> > >
> > > Which is a problem, because that means a non-member doesn't
> > > have access to the corrected schemas.  If we are going to
> > > "publish" an erratum with corrected schemas, it seems that
> > > non-members should be able to access those schemas.
> > >
> > > Given the ongoing inadequacies in the OASIS web site setup,
> > > perhaps this idea of an Errata page is too much trouble.
> > > It seemed like such a simple, obvious idea--like the W3C
> > > uses--but if it's going to be so difficult to do right,
> > > I'm ready to give up on it.
> > >
> > > paul
> > >
>