Hacker News new | ask | show | jobs
by colomon 5006 days ago
I don't know squat about your specific examples, but I couldn't agree more with the general principle. In my sub-field, the obvious example is the ISO-designed STEP file format, which several times longer than the older IGES standard (exact count is hard to get because the STEP standard is split up into dozens of books, not all necessarily relevant) yet is drastically less specific about how you actually put together a meaningful file.

For instance, the STEP AP203 standards document is 500+ pages long. (That's the old edition, I don't have a printed copy of the second edition handy.) But those pages don't tell you how to use the hundreds of classes they define to actually create a meaningful file. For that you need the supplemental "recommended practices" document (http://www.steptools.com/support/stdev_docs/express/ap203/re...), which has been marked "preliminary" for the last 14 years and is itself not particularly clear. (On the bright side, at least it's free!)

Of course, that only applies to one of the many different STEP application protocols, and while I did find a reference to an AP214 (which I also need to support) recommended practices document, the link to it was dead.