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

- Raw text -