Re: Software Documentation
Most of people who ask for documentation never bother reading them. They do however like to "visualize" it somehow - perhaps a Visio workflow diagram will help.
Also, you may include page (or two) explaining underlying technologies (it could also be a high level diagram).
It's interesting to watch people's reaction when you mention technologies - most of them don't understand a word but will look fascinated. :)
Sometimes they may even ask you what programming language you used and why (probably because they've heard of something and would like to participate).
Regardless you definitely need to explain in a nutshell what your app does and what makes it so special or better vs some competition.
There are plenty of software documentation templates out there so try google to find what fits you best.
Re: Software Documentation
I'd like to add some emphasis to RBs first sentence (perhaps the governor would pardon him for his second sentence).
Add an Executive Summary or Abstract to the top. The point of that is to be SHORT! Half a page, tops, should be your target. In that summary, state what the program will do, and how it will benefit the company, stripped of all technological langauge unless you know that some phrase is essential. Most people will read ONLY the summary, so it IS your sales pitch. The rest of the material is supporting information to demonstrate that you have more than just the summary language.
Re: Software Documentation
Thanks a lot, guys. That's exactly what I needed :D
Re: Software Documentation
If the application is already made like you said, the best presentation might be a few examples (short videos or slides) of it in use.
Re: Software Documentation
Quote:
Originally Posted by
baja_yu
If the application is already made like you said, the best presentation might be a few examples (short videos or slides) of it in use.
The way they made it sound, was they wanted to see the documentation to see if they were interested.
Would it be wise to insert slides/pictures in the documentation to help explain parts?
Re: Software Documentation
Yea, screenshots won't hurt but they need to be presentable and right to the point.