delorie.com/archives/browse.cgi | search |
X-Authentication-Warning: | delorie.com: mail set sender to geda-user-bounces using -f |
X-Recipient: | geda-user AT delorie DOT com |
DKIM-Signature: | v=1; a=rsa-sha256; c=relaxed/relaxed; |
d=gmail.com; s=20120113; | |
h=mime-version:in-reply-to:references:date:message-id:subject:from:to | |
:content-type; | |
bh=uk+DH0kcGdB4feW3PagDfcIx0Jt25IgzutXdkVo0P3w=; | |
b=xOTP/jPCIP3Kpeh1AuRev2kwL4KY+tQ8AoocvBphg9Ead1bAyJS9RvZN5mikntSleN | |
z+ICae/MDUupBDone93RynqLOwy1B7KyPX/wvdNeuh0YTDVpDrNa6xDlLn/i2EotktZz | |
5IaX/GxfHr6x9U+npC5uyallLaJsPYdI/BCyTUnMbaYwjRPC8/Vcjzy5TWQ/COLk4JVT | |
FuoItmH77skSFgLTfGwAuk3BodFesHpb/YWG1slkPOxCqTFjAc2Kqkp2AodVVEyYc0vR | |
u68gCxmo9h96mWiYd5pXfP+8GIpMS3vJZkhq2Qr5b5MjUVqBOLTC+m2MYOBjwRY8XpfB | |
0OZA== | |
MIME-Version: | 1.0 |
X-Received: | by 10.50.112.167 with SMTP id ir7mr8526019igb.27.1397885872846; |
Fri, 18 Apr 2014 22:37:52 -0700 (PDT) | |
In-Reply-To: | <201404182030.s3IKUJAN002585@envy.delorie.com> |
References: | <alpine DOT DEB DOT 2 DOT 10 DOT 1404182110510 DOT 20519 AT home DOT local> |
<201404182030 DOT s3IKUJAN002585 AT envy DOT delorie DOT com> | |
Date: | Fri, 18 Apr 2014 22:37:52 -0700 |
Message-ID: | <CAC4O8c8YWyQq7w++kVXm0=d1nVbopNMizj7ux-9iGk0OfL=WTg@mail.gmail.com> |
Subject: | Re: [geda-user] Wiki structure |
From: | Britton Kerin <britton DOT kerin AT gmail DOT com> |
To: | geda-user AT delorie DOT com |
Reply-To: | geda-user AT delorie DOT com |
Errors-To: | nobody AT delorie DOT com |
X-Mailing-List: | geda-user AT delorie DOT com |
X-Unsubscribes-To: | listserv AT delorie DOT com |
On Fri, Apr 18, 2014 at 1:30 PM, DJ Delorie <dj AT delorie DOT com> wrote: > > The PCB manual is managed through the git repo and copied to the web > pages as part of the release process. Please leave it where it is. > As for making the project sites "obsolete" - no, please leave them > alone. Among other things, they act as an official "landing page" and > advertisement for each project, independent of the wiki. > > The front page has been carefully designed to be a decent intro page, > with links to all the projects in a concise format. Please don't > wikify it. I like the sitemap Roland created much better than http://www.geda-project.org/, for the following reasons: * The sitemap has visible top-level links to all the HOWTO FAQ etc that you need to read to make gEDA do anything * It doesn't send you to http://wiki.geda-project.org/ for the wiki, which is a relatively poor page on the wiki that should probably go away in favor of Roland's better sitemap * It links to the useful FAQs and HOWTOs, rather than this less useful one: http://wiki.geda-project.org/geda:faq * It doesn't have a big bloated description of what gEDA is * It doesn't artificially elevate the status of the individual tool docs over the 'glue' docs that you need to read to do anything with gEDA. gEDA is a very much a toolbox and www.geda-project.org ends up being misleading about the extent to which that is true * It shows what translations are available up front www.geda-project.org does have some glossy icons for the tools but that's about all there is to recommend it. IMO it would be better if it went away in favor of the wiki. I respectfully submit that DJ and Peter are probably not the best people to make judgements about how the gEDA docs might be improved. They are the most expert users around and aren't well situated to judge what is confusing and off-putting to new users. How about letting people who want to improve the docs have a shot at it? Note that this would necessarily involve letting them remove some things, as gEDA docs are seriously plagued by redundancy and unclarity about what the new user needs to read to get going. Britton
webmaster | delorie software privacy |
Copyright © 2019 by DJ Delorie | Updated Jul 2019 |