Re: The Gnoga project goals - Ada Advocay for Businesses

[Hubert <herrdoktor@fumanchu.com>]

I hope it works out. I am beginning to see the benefits this could have 
for my own projects already.

One thing to consider is the documentation though. I know you already 
worked on tutorials. The usual Open Software piece on Source Forge is 
mostly useless unless you are already familiar with the concept of the 
software's problem domain or are familiar with similar software. The API 
entries are documented at all and if they are, they don't help much 
because having an API call documented and knowing how and when and why 
to use it are two different pairs of shoes.

Lack of documentation is really what puts off most people when it comes 
to Open Source software, I know it does for me. So my advice would be: 
Write, Write, Write! Also don't assume everybody knows about HTML5, CSS 
and whatnot (I know I don't, I never wrote a website, I never wrote 
anything in Java, I never even touched Java) so whatever knowledge from 
those fields is necessary, you should supply in documentation.

Usually people who ask for documentation in Open Source projects get the 
answer "well it's Open Source, you write documentation and publish it" 
so I don't even ask for it in most cases, but this project sounds 
ambitious enough that it would be a shame if it would fall behind simply 
because of bad documentation.



---
This email is free from viruses and malware because avast! Antivirus protection is active.
http://www.avast.com