@Lillie_Harris may I ask what DITA is?
Is it this?
Is this what the change to the man pages is all about?
The new Help portal is āall aboutā a significant improvement to how we deliver our documentation. Itās different, and I appreciate that some people might not like the new portal, or might need some time to get used to it, but on many levels itās an improvement.
The fundamental information (the content of the manuals, their availability as webhelp and PDF simultaneously, etc) has not changed.
The question was not that. It is āwhat is DITAā that you mentioned in your announcement.
Yes, itās some kind of single-source information system. Works with some major software like
https://www.adobe.com/products/framemaker/xml-dita-editor.html
et al.
3 Likes
So DITA is a content-management system?
1 Like
Not exactly. In simple terms, DITA is a way of structuring information. Because it uses XML, you can think of it as a kind of file format for structured documentation. The documentation is authored in DITA, and then it can be published in a variety of formats, including HTML web help and a PDF book.
2 Likes
Does it follow, then, that the author only has to ātouchā the content once and it will be āpushed outā to web and PDF versions?
In theory, yes, you could set things up such that you have a continuous integration system that automatically deploys a new version of the documentation every time you make an edit to any file, but in practice thatās not how we work, because the manuals team work towards synchronising their releases with the software releases to which they correspond. However, if we needed to update the docs urgently for some reason, itās possible to do somewhat automatically, and both the web help and PDF would be updated accordingly.
3 Likes
Very cool. Not only saves author(s) some time in not duplicating āurgentā efforts, but also helps with consistency at just such moments as keeping track could be extra challenging.
But I can understand why you wouldnāt want to go the full ādriverless carā route with automation on it.
(And, of course, since the information is Darwinian, only the fittest user manuals will surviveā¦)
1 Like
Well I posted that link in the OP to ask if it is this.
Oh! sorry Androā¦ I need to change my glasses. 
1 Like