"Feature complete" XProc draft

Folks,

I believe that the editor's draft at

  http://www.w3.org/XML/XProc/docs/ED-xproc-20060821/

is feature complete. That is to say, I think I've made a pass at
describing all of the decisions that we made at the face-to-face
meeting.

If the document *is* feature complete, then I won't make any more
changes before our 31 Aug 2006 telcon so that we have a stable draft
to review. If anyone reports a significant oversight, I'll try to add
material covering whatever I overlooked as quickly as possible.

A few of general notes:

- I think there's a little bit of "sloppiness" in the draft when it
  comes to step/component names. Sometimes I say "step name" where I'm
  referring to a component, for example. I think the right answer is
  to say that components have names too and to say component name when
  we're talking about a component. But that seems too small an
  editorial issue to justify holding up publication of the draft for
  our internal review.

- Something about the build process is inserting extra spaces in some
  places. So you see, for example, things like " some thing " where
  "some thing" was intended. Don't worry about those, they'll all get
  fixed when I debug the build issue.

- Similarly, I think there are some places where I need to provide
  some typographic distinctions that are currently missing.

- To make the review process easier, I suggest separating technical
  issues from editorial ones. Let's start a separate email thread for
  each significant technical issue so that we can track it. You can
  put all the editorial stuff in one message.

                                        Be seeing you,
                                          norm

-- 
Norman Walsh
XML Standards Architect
Sun Microsystems, Inc.

Received on Monday, 21 August 2006 22:02:23 UTC