Questions generated as authors write the first draft

Use this page to keep track of questions that occur to you as you write the first draft.

Robert Anderson

Kris Eberlein

JoAnn Hackos

Nancy Harrison

Erik Hennum

A little concerned about the task orientation -- specifications are typically used to verify the result of implementation rather than as guidance for how to implement (because the implementation details will be specific to each vendor and because the vendor's innovation is in the implementation).

WEK: I agree with Erik. In editing his submissions, I realized that having "how to" topics is not appropriate for a specification: rules need to be defined declaratively. They can be supported by non-normative examples (the XSLT 2 spec is an excellent example of this approach), but the arch spec is not and should not be a tutorial. Of course, we should probably publish, through the DITA Adoption TC, a companion how-to document that can include all the tasks currently identified for the arch spec.

Gershon Joseph

Eliot Kimber

AuthorsQuestions (last edited 2009-08-26 15:54:32 by keberlein)