From mboxrd@z Thu Jan  1 00:00:00 1970
Message-ID: <ee9e417a0511241654u74d78dei44fd1ae2cb4727be@mail.gmail.com>
Date: Thu, 24 Nov 2005 19:54:30 -0500
From: Russ Cox <rsc@swtch.com>
To: Fans of the OS Plan 9 from Bell Labs <9fans@cse.psu.edu>
Subject: Re: [9fans] sources/contrib index
In-Reply-To: <20051124222518.GJ12975@server4.lensbuddy.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable
Content-Disposition: inline
References: <20051124222518.GJ12975@server4.lensbuddy.com>
Topicbox-Message-UUID: b18bc092-ead0-11e9-9d60-3106f5b1d025

> [3] http://plan9.bell-labs.com/wiki/plan9/Mirrors/

Here is an important tip for writing wiki pages:
   *** explain what the point is ***

This page is a perfect example of a bad page.
It is just a collection of links with no explanation
of why you might want to click on those links
or what the bigger context is.

There should always be a couple of sentences
at the top of the page explaining what's going on.
It makes a huge difference in the usability of
the page, especially if one is following a hyperlink
in an email or external server and has no context
at all.

The problem is not limited to the above page.
Many pages suffer from this problem.

I try to clean these up as I see them, but I don't
always have time.

Thanks.
Russ