3 ms·

We used DITA extensively for many years. DITA was largely awesome in terms of authoring, we could and did produce HTML and PDF with one click, but the tools wer

• ainar-g 7y ago
  > My company is now moving to putting their docs in confluence, which I hate. The only good thing I've found so far about Confluence is that you can kind-of-sort-of escape its WYSIWYGness by pressing the small “<>” (“Edit Source”) button at the top and just paste your XHTML, that you've written like a normal human being, in there. But of course it only supports a subset of XHTML, doesn't support anything CSS beyond very basic styling, and it makes it very hard to work with tables of contents and other extensions.
  • doctor_eval 7y ago
    That’s a good idea. I found confluence’s UI to be almost unusable. I was constantly fighting style changes, like spending 5 minutes trying to un-bold something when I should have been getting my brain dumped.
• welcome_dragon 7y ago
  > My company is now moving to putting their docs in confluence, which I hate. Still better than SharePoint! ... Though I've taken to writing as much in markdown and storing with my code as possible. Our build process can compile code in the docs to ensure that it stays in sync