JeffGarland
commented
5 years ago with format and other changes and consolidations we are down to 33 pages -- that's much more reasonable although still long. At the moment I'm inclined to leave things as is so I'm closing this issue.
So I pushed an early version of the pdf. I did this just so others could have a look at how things are laying out. This is not nearly as important as fixing content at this stage as I can tweak this right up to the end without external help. I clearly need to tweak the page formatting and a number of other usage factors which should improve the layout.
All that said, it quite a long proposal so we should think of what may be expendable. In my mind I'm considering removing all of the technical specification with the exception of 'header process' and 'header pstream'. So what would remain is basically a list of all the classes, functions, and types without all the details. Opinions and thoughts appreciated.
I'm a huge fan of what is now called Design Discussion and Examples. That's basically this part of the paper. Really I think that documents 99% of what people need to know.