Date: 17 Oct 2002 15:07:04 -0700 From: "Gary W. Swearingen" <swear@attbi.com> To: FreeBSD-gnats-submit@FreeBSD.org Subject: www/44181: www "Release Information" organization Message-ID: <8wy98w4t4n.98w@localhost.localdomain>
next in thread | raw e-mail | index | archive | help
>Number: 44181
>Category: www
>Synopsis: www "Release Information" organization
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-www
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: change-request
>Submitter-Id: current-users
>Arrival-Date: Thu Oct 17 15:10:01 PDT 2002
>Closed-Date:
>Last-Modified:
>Originator: Gary W. Swearingen
>Release: n/a
>Organization:
none
>Environment:
n/a
================
>Description:
At www.freebsd.org, the organization of information related to getting
and installing FreeBSD (other than the confusingly-labeled "Current"
version) is rather poor, making it unnecessarily hard to find. It also
omits some related introductory information to give newbies a clue.
(The fix involves swapping some info between two pages, adding a little
introductory info to one, and changing a couple links on the home page.)
1) The listing of "release" documents is spread across these two pages:
http://www.freebsd.org/releases/index.html "Release Information"
http://www.freebsd.org/relnotes.html "Release Documentation"
and mixed (on both pages) with some information about the releases
themselves (as opposed to being about the release documentation).
2) The home page's "Documentation" menu doesn't have an entry for the
release documentation while the "Software" menu has a link to a page
which says little about software (it's almost all about documentation).
The two OS-related links under "Software" are also sorely lacking in
introductory material and so are rude to newbies. Finally, that
"Software" menu would be easier to navigate with the software divided
into "base OS" and "application/ports/packages" sub-categories (eg,
by just having two such links instead of the current three).
================
>How-To-Repeat:
n/a
================
>Fix:
The general idea is to make relnotes.html cover the release docs
and make releases/index.html cover the base OS software release:
On the home page, replace the "Getting FreeBSD" and "Release
Information" links under "Software" with one link to releases/index.html
labeled "Base OS" or "Base Operating System" or "Operating System" or
or "FreeBSD OS" or "Base FreeBSD OS" or "Base OS Distributions" or ...
Under "Documentation", add a link to relnotes.html as "Release Docs".
Move from releases/index.html the "Current Releases" and "Past Releases"
sections into the "RELEASE versions of FreeBSD" section of
relnotes.html, removing that section's first paragraph.
Rework the remaining "Future Releases" section of releases/index.html
to remove the redundant schedule information but say that the schedule
is at releng/index.html .
Add to the same page an "Introduction" section with a brief introduction
of the concept of "distributions" and "releases", etc. and refer to the
handbook's section on the subject. Add another section on "Getting
FreeBSD" with a brief intro to getting FreeBSD distributions and refer
to the handbook's with the "Getting FreeBSD" link now on the home page.
>Release-Note:
>Audit-Trail:
>Unformatted:
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-www" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?8wy98w4t4n.98w>