Bug 253706 - Website's 'features' page is outdated
Summary: Website's 'features' page is outdated
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Website (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: freebsd-doc (Nobody)
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2021-02-19 23:15 UTC by Mitchell Horne
Modified: 2022-07-23 08:56 UTC (History)
3 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Mitchell Horne freebsd_committer freebsd_triage 2021-02-19 23:15:46 UTC
Today I stumbled upon the page at https://www.freebsd.org/features/ which describes some of the unique technical features offered by FreeBSD.

The page has detailed entries for both 9.X and 10.X releases, but nothing more recent than that, meaning we lack any information on newer features present in actively supported releases.

This page offers useful information about what makes FreeBSD unique and is accessible from the front page of the website. Presenting older features as new in this way only serves to make the project appear outdated. Since it does seem like some effort will be required to update it, it could be that it is a better candidate for removal.
Comment 1 Daniel Ebdrup Jensen freebsd_committer freebsd_triage 2021-02-20 05:10:17 UTC
Would it be better to refer users to the release notes for major versions, instead of deleting the page?

They typically include all the bigger changes, and it also means not having to keep track of newer changes separately.

For the -CURRENT branch, we can direct users to look at src/RELNOTES and a cgit log query like this:
https://cgit.freebsd.org/src/log/?showmsg=1&qt=grep&q=Relnotes
Comment 2 Graham Perrin freebsd_committer freebsd_triage 2022-07-15 03:09:53 UTC
https://reviews.freebsd.org/D35823
Comment 3 commit-hook freebsd_committer freebsd_triage 2022-07-23 08:52:34 UTC
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/doc/commit/?id=89aea52bac8631334da97d837afaf5173a278e3e

commit 89aea52bac8631334da97d837afaf5173a278e3e
Author:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
AuthorDate: 2022-07-23 08:44:43 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2022-07-23 08:51:00 +0000

    Upgrade FreeBSD features page

    * Complete rewrite of features page

    The page must be improved in another batch of reviews

    PR:                     253706
    Reviewed by:            delphij@, grahamperrin@, fernape@, lwhsu@,
                            pauamma@, oshogbo@, dvl@
    Differential Revision:  https://reviews.freebsd.org/D35823

 website/content/en/features.adoc | 116 ++++++++++++++++++++++++++-------------
 1 file changed, 79 insertions(+), 37 deletions(-)
Comment 4 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2022-07-23 08:56:55 UTC
I'm gonna close this PR.
The page is now updated.
As I pointed in the commit. The page must me improved in another batch of reviews.
Thanks to all of you.