(as someone currently picking at a semantic approach to granularly single-sourcing documentation...) I think there are a lot of small factors that create a big

(as someone currently picking at a semantic approach to granularly single-sourcing documentation...) I think there are a lot of small factors that create a big headwind for semantic markup, but I think the most important are: 1. Semantic markup can make it easy to build bigger/better levers, but a lot of these aren't universally useful. (They aren't compelling reasons for most people to suffer.) 2. There's no great starting point you can recommend to anyone from which they'll be able to incrementally improve their documents and start building levers without large up-front investments.