Tools for writing application documentation
-
For the purpose of documentating an application, I'm looking for a WYSIWYG editor that can yield both in HTML and PDF formats, but meets a few other criteria. [More Inside] Criteria: - Need WYSIWYG: don't want to muck with HTML across a large document - Need HTML: organized and hyperlinked from a table of contents at the top, so it can be read "top down" or as in-program documentation by linking to the appropriate page. - Need PDF: shouldn't be a big issue since I can probably render PDF from whatever HTML I end up with. - Need automatic TOC generation/upkeep that links to the referenced item - Nice to have: automatically include a link back to the TOC at the end of each section. If I had to do this by hand it wouldn't be the end of the world. What I already considered: - Word: WYSIWYG, does the TOC the way I'd like, but really afraid of the HTML it would generate - Open Office: WYSIWYG, does TOCs but doesn't link to the referenced location, HTML hopefully sucks less than Word's - Generic WYSIWYG HTML tools: don't automatically do a TOC Any ideas on other tools I could check out? Free/open source solutions a big plus.
-
Answer:
Adobe Framemaker could do it....but be the learning curve is steep and the price is high.
turbodog at Ask.Metafilter.Com Visit the source
Other answers
Have you checked out RoboHelp?
mkultra
2nd the Framemaker recommendation. Yes, the learning curve is steep, BUT . . . It will output the best PDF you've ever seen. It will make maintaining and updating the document a breeze It will save you days and days building and updating the TOC, index, numbering, etc. Shame they've stopped developing it for the Mac.
cptnrandy
Related Q & A:
- Unix tools: what if a file is named minus something?Best solution by Super User
- Can I get OSQL if I install SQL Server Client Tools?Best solution by Database Administrators
- How do I generate documentation for a project?Best solution by Stack Overflow
- How would you handle a special handling situation in the absence of any information or proper documentation?Best solution by answers.yahoo.com
- Writing sample for job application?Best solution by monster.com
Just Added Q & A:
- How many active mobile subscribers are there in China?Best solution by Quora
- How to find the right vacation?Best solution by bookit.com
- How To Make Your Own Primer?Best solution by thekrazycouponlady.com
- How do you get the domain & range?Best solution by ChaCha
- How do you open pop up blockers?Best solution by Yahoo! Answers
For every problem there is a solution! Proved by Solucija.
-
Got an issue and looking for advice?
-
Ask Solucija to search every corner of the Web for help.
-
Get workable solutions and helpful tips in a moment.
Just ask Solucija about an issue you face and immediately get a list of ready solutions, answers and tips from other Internet users. We always provide the most suitable and complete answer to your question at the top, along with a few good alternatives below.