Bug 265264 - Make /ports/ less obscure, and add a link out to FreshPorts
Summary: Make /ports/ less obscure, and add a link out to FreshPorts
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Website (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Many People
Assignee: freebsd-doc (Nobody)
URL: https://github.com/freebsd/freebsd-do...
Keywords:
Depends on:
Blocks:
 
Reported: 2022-07-17 08:22 UTC by Graham Perrin
Modified: 2022-07-24 10:43 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 Graham Perrin freebsd_committer freebsd_triage 2022-07-17 08:22:46 UTC
<https://www.freebsd.org/ports/> will benefit from a link out to: 

    <https://www.freshports.org/>

There's already a link out from <https://www.freebsd.org/ports/searching/>, however the scope of FreshPorts is much broader than search. It should be more prominently linked. 

Also, <https://reviews.freebsd.org/D35819>: 

> ⚙ D35819 Upgrade ports intalling section

– and bug 265253.
Comment 1 Graham Perrin freebsd_committer freebsd_triage 2022-07-17 09:04:57 UTC
FreeBSD home page <https://www.freebsd.org/> has shouty but easily overlooked: 

    SHORTCUTS

– with five shortcuts, including: 

    Ports <https://www.freebsd.org/ports/>

Stepping away from home loses SHORTCUTS. 

Four of the five remain easily accessible through main menus: 

* the Community menu for mailing lists

– and so on. 

For what was the fifth shortcut, Ports, there's: 

* no direct route from any menu. 

Early thoughts
==============

Remove the 25th anniversary stuff, which should have been removed years ago. <https://reviews.freebsd.org/D34410> via bug 261058. With all due respect: it's stale clutter, the combination of those two aspects decreases the likelihood of people paying attention to adjacent stuff such as shortcuts. 

Using uppercase for SHORTCUTS might have been intended to attract attention (shouting) however there should be no need for this section of the page. 

The main menus – seven, adjacent to the Home button – should be more than enough to comprise all five shortcuts in a way that is both logical and accessible. 

Allow the main menus to serve their purpose. 

<https://www.freebsd.org/about/> (from a click on the 'About' menu button, unfortunately not a menu item) mentions ported libraries and applications.

Improve the About menu: 

* 'Introduction' should refer to <https://www.freebsd.org/about/>
                          not to Resources for Newbies

* add a menu item <https://www.freebsd.org/projects/newbies/>, named 
  'Newcomers' or 'Newbies' or 'Resources for Newbies' (although the 
  word newbies might too colloquial for a menu for a project such as 
  FreeBSD … needs more thought)

* add a menu item 'Ports Collection' <https://www.freebsd.org/ports/>.

Then remove the SHORTCUTS area from the home page (and so on … a broader discussion, for anyone who'd like to join me in chat). 

Thanks
Comment 2 Graham Perrin freebsd_committer freebsd_triage 2022-07-17 12:27:58 UTC
(In reply to Graham Perrin from comment #1)

> … enough to comprise …

Correction: 

> … enough to include …
Comment 3 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2022-07-24 10:04:44 UTC
I'm gonna:

* Add FreshPorts to the ports sidenav
* Remove the 25th anniversary stuff
* Change to lowercase the SHORTCUTS
* Add a link to ports to the about menu

About the other things. I'm gonna finish in a couple of weeks the new manual pages using Mandoc. When I have this finished I'll start with the new website.
And then we can talk about the new menus, etc.
I'll ping you when I'm gonna start this.
Comment 4 commit-hook freebsd_committer freebsd_triage 2022-07-24 10:42:53 UTC
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/doc/commit/?id=41a39b1b9049a17b2a63c59e07d7adee5a362cc2

commit 41a39b1b9049a17b2a63c59e07d7adee5a362cc2
Author:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
AuthorDate: 2022-07-24 10:40:13 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2022-07-24 10:40:13 +0000

    Make ports page less obscure and add links to FreshPorts

    Changes:

    * Make ports page less obscure adding a link in the about menu
    * Put SHORTCUTS in lowercase
    * Add FreshPorts link in the ports sidenav section

    PR:             265264
    Submitted by:   grahamperrin@

 website/themes/beastie/i18n/de.toml                          | 2 +-
 website/themes/beastie/i18n/en.toml                          | 2 +-
 website/themes/beastie/i18n/es.toml                          | 2 +-
 website/themes/beastie/i18n/nl.toml                          | 2 +-
 website/themes/beastie/layouts/partials/sidenav.html         | 1 +
 website/themes/beastie/layouts/partials/site-navigation.html | 3 +++
 6 files changed, 8 insertions(+), 4 deletions(-)