Writing documentation as XML is powerful but not enjoyable at all I guess
DITA's benefits require a certain scale that most tech companies never achieve. And the Open Toolkit is a nightmare piece of software.
OxygenXML makes the OT much more manageable. I haven't had to touch an OT XSL transform in a few years now. Worth every penny.
We're defining a new document language in XML called "Press". It really feels like this is the area where XML shines. We have custom tags and components, easily defined within the document (or separated into different files). We intend to open source the language - we're not rolling out the typesetting API until later this month.
We looked at markdown extensions. I checked with our researcher and he did take a look at Quarkdown and a bunch of others. His first reaction was to compare it to typst [2] and also had some difficulty getting Quarkdown running on his machine.
We like what typst has done, but Papermill is more focused on "design-first" - supporting more general designs - and automation.
Your "free trial" is behind a sign-up wall. and I left.
This seems extensible to the degree that I want (i.e. semantically rich enough that you can conceivably hang any application from it). But I just can't bring myself to write in XML syntax, especially for maths.
I haven't really tried writing large pieces of text in it but I am already seriously considering. All other alternatives are too complicated and have a learning curve that gets in the way of writing itself. With XML, I'd be able to define my own tags and run them by a parser later on to auto-generate indexable footnotes, and create my own ways of structuring text besides the usual ones (chapters, sections, etcetera). Has anyone tried this approach?