X-Authentication-Warning: delorie.com: mail set sender to geda-user-bounces using -f
X-Recipient: geda-user AT delorie DOT com
X-Authority-Analysis: v=2.0 cv=RoZH3VaK c=1 sm=0 a=6jktZp3dcHAl1vye2O6wCg==:17 a=jl9P3j1e7_0A:10 a=yvSPhu-8laEA:10 a=qYqmmwKKcu4A:10 a=6WB07kdHjWAA:10 a=8nJEP1OIZ-IA:10 a=wR-FlJDvAAAA:8 a=EiAacCyhH7YA:10 a=1i0U63oc5wF903B2cDwA:9 a=wPNLvfGTeEIA:10 a=6jktZp3dcHAl1vye2O6wCg==:117
X-Cloudmark-Score: 0
X-Originating-IP: 70.113.67.117
Message-ID: <50967F73.9010105@ecosensory.com>
Date: Sun, 04 Nov 2012 08:45:07 -0600
From: John Griessen <john AT ecosensory DOT com>
User-Agent: Mozilla/5.0 (X11; Linux i686; rv:10.0.9) Gecko/20121015 Icedove/10.0.9
MIME-Version: 1.0
To: geda-user AT delorie DOT com
Subject: Re: [geda-user] The state of gEDA/gaf (Was gEDA/PCBs diversity, Was:
 Pin hole size)
References: <CANqhZFxYH+Y5U1ai7ey-s+4nz6eYDM2vx3aMDb7WuigNXmi4AQ AT mail DOT gmail DOT com> <1511E63C-F435-44B1-9734-C7AF7AF49A92 AT sbcglobal DOT net> <20121030132922 DOT GY32696 AT fi DOT muni DOT cz> <201210312340 DOT q9VNe3VW012697 AT envy DOT delorie DOT com> <CAC4O8c-xvCH8j2h3K3+ymO0Zgbru_JqDavqojY81iT_C=-zPrw AT mail DOT gmail DOT com> <CAGde_xOu96b1jxN1n2km3_OAkX9umshs9FQF+Gdjgsbw_Mt4qQ AT mail DOT gmail DOT com> <CAC4O8c8BiPJSJyvTDs337ix2e==+bLwzz3TgqD8rV+B4TPkSxw AT mail DOT gmail DOT com>
In-Reply-To: <CAC4O8c8BiPJSJyvTDs337ix2e==+bLwzz3TgqD8rV+B4TPkSxw@mail.gmail.com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Reply-To: geda-user AT delorie DOT com

On 11/03/2012 05:10 PM, Britton Kerin wrote:
> The gEDA project was started because of the lack of free EDA tools for
>       POSIX systems with the primary purpose of advancing the state of free
>       hardware or open source hardware. The suite is mainly being developed
>       on the GNU/Linux platform with some development effort going into making
>       sure the tools run on other platforms as well.
>
> Users have said they find the docs painful so getting rid of anything useless
> in them is worthwhile.


Useless is a strong critique of two sentences of background and purpose statement.

Maybe if you sent an improved writing version?  If you're saying nothing
but the practical facts of use should be on the site, then maybe drop the
FOSS license too?  Pragmatists would love that.

The pain in the docs is the usual pain of incompleteness, too many cross references,
few examples, some old info still in there, etc.  A lot more than the mission statement needs
editing, verbage defogging and consistent style.  And the docs need much testing that they work for beginners.