On Wed, Jan 8, 2020 at 6:29 PM Martin Westhead <martin@westhead.me> wrote:
Hi Mike,Here is the latest version of the comments - I’m up to page 123 (still a ways to g o I’m afraid).I have to say it’s great the see DFDL finished. I’m excited for the small part I have played in its journey.Things definitely improved after page 82. Since it became more clearly reference and less narrative and the forward references were referring to things that were closer and at a much more detailed level.So I think the real challenge with the doc is pages 20-80 that seem to be telling a story but use concepts and ideas that have not be defined/introduced to the reader. Meaning that the doc would need multiple passes to be comprehensible. My suggestion would be to try to extend the introductory material to introduce some of the key missing ideas like Infoset and property and talk a little about how the properties are arranged on the XML elements. It probably not that much but could make the doc much more comprehensible.The next few weeks I am mostly going to be slammed - I’m racing to deliver value in my new role and have a lot of ground to cover. But I’m happy to chip away at the doc as best I can (commenting is faster now post p82). Let me know if there is a date beyond which it is no longer useful?Thanks for pulling me back in - its great to see what you have created...Martin
