Bug 44181

Summary: www "Release Information" organization
Product: Documentation Reporter: Gary W. Swearingen <swear>
Component: DocumentationAssignee: freebsd-doc (Nobody) <doc>
Status: Open ---    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Gary W. Swearingen 2002-10-17 23:10:01 UTC
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).



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.
How-To-Repeat: n/a
Comment 1 Gary W. Swearingen freebsd_committer 2005-10-07 19:46:32 UTC
State Changed
From-To: open->analyzed

I'll try to fix the problems. 

Comment 2 Gary W. Swearingen freebsd_committer 2005-10-07 19:46:32 UTC
Responsible Changed
From-To: freebsd-www->garys

I'll take it.
Comment 3 Mark Linimon freebsd_committer freebsd_triage 2006-01-28 20:05:18 UTC
Responsible Changed
From-To: garys->freebsd-www

Assignee has asked to resign his commit bit, so return this one to pool.
Comment 4 Gabor Kovesdan freebsd_committer 2007-02-01 21:25:38 UTC
State Changed
From-To: analyzed->open

Open for the wide publicity again.
Comment 5 Remko Lodder freebsd_committer 2009-11-05 13:13:02 UTC
Responsible Changed
From-To: freebsd-www->re

I think this is more something for the RE team...
Comment 6 Eitan Adler freebsd_committer freebsd_triage 2017-12-31 07:58:38 UTC
For bugs matching the following criteria:

Status: In Progress Changed: (is less than) 2014-06-01

Reset to default assignee and clear in-progress tags.

Mail being skipped