From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=unavailable autolearn_force=no version=3.4.4 Path: eternal-september.org!reader01.eternal-september.org!reader02.eternal-september.org!news.eternal-september.org!mx02.eternal-september.org!feeder.eternal-september.org!news.glorb.com!peer02.iad.highwinds-media.com!news.highwinds-media.com!feed-me.highwinds-media.com!post02.iad.highwinds-media.com!fx27.iad.POSTED!not-for-mail From: Hubert User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:31.0) Gecko/20100101 Thunderbird/31.2.0 MIME-Version: 1.0 Newsgroups: comp.lang.ada Subject: Re: The Gnoga project goals - Ada Advocay for Businesses References: In-Reply-To: Content-Type: text/plain; charset=windows-1252; format=flowed Content-Transfer-Encoding: 7bit X-Antivirus: avast! (VPS 141112-0, 11/12/2014), Outbound message X-Antivirus-Status: Clean Message-ID: X-Complaints-To: abuse@newsdemon.com NNTP-Posting-Date: Thu, 13 Nov 2014 01:49:03 UTC Organization: http://www.NewsDemon.com Date: Wed, 12 Nov 2014 17:49:11 -0800 X-Received-Bytes: 2350 X-Received-Body-CRC: 2915435795 Xref: news.eternal-september.org comp.lang.ada:23206 Date: 2014-11-12T17:49:11-08:00 List-Id: 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