Building a Documentation System -
I am part of a larger organization in the insurance industry. I am currently looking at ways to manage our internal product documentation and I have to get some feedback for this community.
We are currently reading documents using Word, Excel, Publisher, and PowerPoint. If we want to create a "training manual" that we make a simple copy and take this information into a big word document and then print it as a PDF. Oh joy
This means that all of our documents, internal and external, are stuck in .doc or .pdf files, and you can imagine how fun it is when we have an update!
My primary concerns are:
- Upgradeability - I would like the source to update once and then generate PDF, HTML, etc.
- Portability Open me standard - I have to go away from Microsoft products
I am currently looking at the DocBook, DITA, and maybe a wiki Also would like to get their input on this topic.
What do you think about this type of project? What have you done to provide documentation for your products? Is the Docbook or DITA worth the investment of time?
We have recently terminated the implementation of CMS, and we are very pleased with it Database-backed document repository with Wiki Front End is Daisy's very customizable, open source (runs on Java stack), and has some great features outside the box like:
- PDF And export to standalone HTML
- Sophisticated Access Control
- Anuva
- Full text search powered by Lucene (indexed attachment too)
- Faced Browsing
- ReST API
Comments
Post a Comment