8 Replies - 1041 Views - Last Post: 17 April 2009 - 09:26 AM
Replies To: Documentation
Posted 16 April 2009 - 07:57 AM
But just a couple starter tips I would include screen shots and break down your application or whatever you are documenting as specific and detailed as possible.
Start with basic functionality and progress to more advanced functions.
Document any problems or "hick ups" that the user might incounter. If possible include how to correct/work around the issue.
I would have a cover page with an Index that lays out what the document has included with it. Keep track of the revisions you make and what you added/changed in that revision.
Posted 16 April 2009 - 08:54 AM
What headings do you use? Do you use a program to help you?
As a beginner to documentation I need help!
I have done a lot of documentation and I'm trying to develop a freelancing career doing just that!
If you want to build an integrated help system for your programs you should probably use HTML Help Workshop to develop it. You do need to know a little HTML to use it though.
As for a written manual find a word processor that you like, like Word, WordPerfect or OpenOffice.org are all good choices. OpenOffice.org is nice because you can export your document to a PDF. You could also use Adobe Acrobat to create PDFs. Just use what ever you are most comfortable with. Most modern word processors can import the formats of the other word processors.
You should probably try to develop a professional writing style but since you are just starting out just try to make everything clear and consice.
Document any problems or "hick ups" that the user might incounter. If possible include how to correct/work around the issue
These are all very good ideas for getting started. I can't think of a better way to put it.
Another thing that might help you as you go. Add comments to your code. I know it is a pain but it will help you when you start to write your documentation. You can go into your classes and methods to see what they do and the functionality that they add to your program.
Yes, version control is essential to writing good documentation.
Somethings you might want to try to help you develop your writing skills.
Try writing a blog about something you like. Try writing and explaining snippets. When you get good at that try writing tutorials for others.
That is about all I can think of at the moment.
For some reason my tags aren't working.
This post has been edited by jjsaw5: 17 April 2009 - 04:24 AM
Posted 17 April 2009 - 06:56 AM
Posted 17 April 2009 - 07:07 AM
I guess you could try something like this:
Table of Contents
for each window
I think that would be a good general layout for a document