On 3/8/2016 3:08 AM, Rob van der Heij wrote: > In the style of the z/VM 6.3 books, describing the latest level might > take 3,000 pages. The consistent design of CMS Pipelines makes the > description appear very repetitive and likely obscures the details.
I think Alan Ackerman's comparison with the XEDIT is right on the mark. Each syntax element can be defined in one place, and other uses refer to that place. You could do it like XEDIT and pick stages with simple syntax and associate one syntax element with each: maybe FIND for STRING, STRFIND for DELIMITEDSTRING, CHOP for XRANGE, etc. That would mean following a lot of different references to learn the richer stages, but it would avoid having the references buried in huge collections of information. But I think the current approach of the Author's Edition is really better, with a separate section devoted to the common syntax elements. The one thing I would change is to add a visible note with links to them just under each syntax diagram, in addition to the inline links. ¬R
