Stefan Tilkov's Random Stuff

Don't Design Custom Document Schemas

Tim Bray writes about the pros and cons of constructing your own schema for Office documents, and concludes that it’s simply not worth doing. We did something similar in one of our website and product documentation iterations: designing a custom schema seemed trivially easy at first (just throw in a <para> tag, a couple of <link> and <document> style things and you’re basically done), but what we ended up with seemed like DocBook or XHTML done badly — so we essentially switched to those instead (XHTML for the website, DocBook for the documentation). The fact that you have lots of tools to edit and process and transform those things to multiple possible output formats far outweighs the fact that you initially consider them to be overkill.

Comments