Spec refactor

Ok. The big spec refactor PR is ready for review. It’s #307:

  https://github.com/xproc/3.0-specification/pull/307

You can see the published results of this branch at

  http://xpspectest.nwalsh.com/spec-refactor/head/

The salient points are:

* It removes random dependencies from the build (perl, make, cp).
* It rationalizes the build system, improves how various artifacts
  like schemas are constructed, and copies some of the artifacts
  into the distribution directories.
* Per decisions on Prague, it begins the process of breaking the
  optional steps into separate specifications.
* It restructures the publication so that there's an Overview spec
  that points to all the others.
* I created a new "step introduction" spec that describes common
  features of steps so that they don't have to be repeated in each
  step spec.

It's not supposed to have introduced any substantive changes to the
spec prose.

Oh, and I’m sure there’s more to be done to get everything publication
ready but I think it’s a step in the right direction.

Comments and criticisms invited.

                                        Be seeing you,
                                          norm

-- 
Norman Walsh
Principal Engineer
MarkLogic Corporation
Phone: +1 512 761 6676
www.marklogic.com

Received on Monday, 26 February 2018 14:54:37 UTC