Bug 273247

Summary: Clickable https://www.⋯ URLs do not require a 'WWW: ' prefix
Product: Documentation Reporter: Graham Perrin <grahamperrin>
Component: WebsiteAssignee: Sergio Carlavilla Delgado <carlavilla>
Status: Closed FIXED    
Severity: Affects Some People CC: carlavilla, doc, minsoochoo0122
Priority: ---    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
1990s-like none

Description Graham Perrin 2023-08-20 17:58:18 UTC 
Created attachment 244231 [details]
1990s-like

The WWW: approach in areas such as <https://docs.freebsd.org/en/books/handbook/book/#mirrors-cdrom> creates a sense of things being archaic. 

Please consider modernisation of some such files.


Books & Articles (component in Bugzilla): 

% rg --count --sort path 'WWW:' /usr/doc/documentation/content
/usr/doc/documentation/content/de/books/handbook/mirrors/_index.adoc:4
/usr/doc/documentation/content/de/books/porters-handbook/quick-porting/_index.adoc:2
/usr/doc/documentation/content/el/books/handbook/mirrors/_index.adoc:11
/usr/doc/documentation/content/el/books/handbook/ports/_index.adoc:1
/usr/doc/documentation/content/en/books/handbook/mirrors/_index.adoc:3
/usr/doc/documentation/content/en/books/handbook/mirrors/_index.po:3
/usr/doc/documentation/content/en/books/handbook/ports/_index.adoc:2
/usr/doc/documentation/content/en/books/handbook/ports/_index.po:2
/usr/doc/documentation/content/en/books/porters-handbook/makefiles/_index.adoc:1
/usr/doc/documentation/content/en/books/porters-handbook/makefiles/_index.po:1
/usr/doc/documentation/content/en/books/porters-handbook/security/_index.adoc:1
/usr/doc/documentation/content/en/books/porters-handbook/security/_index.po:1
/usr/doc/documentation/content/es/articles/hubs/_index.adoc:1
/usr/doc/documentation/content/es/articles/hubs/_index.po:1
/usr/doc/documentation/content/es/books/handbook/ports/_index.adoc:1
/usr/doc/documentation/content/fr/books/faq/_index.adoc:4
/usr/doc/documentation/content/fr/books/handbook/mirrors/_index.adoc:16
/usr/doc/documentation/content/fr/books/handbook/ports/_index.adoc:1
/usr/doc/documentation/content/hu/books/handbook/mirrors/_index.adoc:15
/usr/doc/documentation/content/hu/books/handbook/ports/_index.adoc:1
/usr/doc/documentation/content/it/books/handbook/mirrors/_index.adoc:17
/usr/doc/documentation/content/it/books/handbook/ports/_index.adoc:1
/usr/doc/documentation/content/ja/books/faq/_index.adoc:2
/usr/doc/documentation/content/ja/books/handbook/mirrors/_index.adoc:3
/usr/doc/documentation/content/ja/books/porters-handbook/quick-porting/_index.adoc:2
/usr/doc/documentation/content/mn/books/handbook/mirrors/_index.adoc:5
/usr/doc/documentation/content/mn/books/handbook/ports/_index.adoc:1
/usr/doc/documentation/content/nl/books/handbook/mirrors/_index.adoc:11
/usr/doc/documentation/content/nl/books/handbook/ports/_index.adoc:1
/usr/doc/documentation/content/pl/books/handbook/mirrors/_index.adoc:4
/usr/doc/documentation/content/pl/books/handbook/ports/_index.adoc:1
/usr/doc/documentation/content/pt-br/articles/hubs/_index.adoc:1
/usr/doc/documentation/content/pt-br/articles/hubs/_index.po:1
/usr/doc/documentation/content/pt-br/books/handbook/mirrors/_index.adoc:4
/usr/doc/documentation/content/pt-br/books/porters-handbook/quick-porting/_index.adoc:2
/usr/doc/documentation/content/pt-br/books/porters-handbook/security/_index.adoc:1
/usr/doc/documentation/content/ru/books/handbook/mirrors/_index.adoc:4
/usr/doc/documentation/content/ru/books/handbook/ports/_index.adoc:1
/usr/doc/documentation/content/ru/books/porters-handbook/quick-porting/_index.adoc:2
/usr/doc/documentation/content/zh-cn/books/handbook/mirrors/_index.adoc:15
/usr/doc/documentation/content/zh-cn/books/handbook/ports/_index.adoc:1
/usr/doc/documentation/content/zh-cn/books/porters-handbook/quick-porting/_index.adoc:2
/usr/doc/documentation/content/zh-tw/books/handbook/mirrors/_index.adoc:4
/usr/doc/documentation/content/zh-tw/books/porters-handbook/security/_index.adoc:1
% rg --count --sort path 'WWW ' /usr/doc/documentation/content
/usr/doc/documentation/content/el/articles/freebsd-questions/_index.adoc:1
/usr/doc/documentation/content/el/books/faq/_index.adoc:2
/usr/doc/documentation/content/el/books/handbook/mirrors/_index.adoc:2
/usr/doc/documentation/content/en/articles/freebsd-questions/_index.adoc:3
/usr/doc/documentation/content/en/articles/freebsd-questions/_index.po:4
/usr/doc/documentation/content/en/articles/hubs/_index.adoc:2
/usr/doc/documentation/content/en/articles/hubs/_index.po:2
/usr/doc/documentation/content/en/books/handbook/desktop/_index.adoc:1
/usr/doc/documentation/content/en/books/handbook/desktop/_index.po:1
/usr/doc/documentation/content/en/books/handbook/ports/_index.adoc:6
/usr/doc/documentation/content/en/books/handbook/ports/_index.po:6
/usr/doc/documentation/content/en/books/porters-handbook/makefiles/_index.adoc:1
/usr/doc/documentation/content/en/books/porters-handbook/makefiles/_index.po:1
/usr/doc/documentation/content/en/books/porters-handbook/security/_index.adoc:1
/usr/doc/documentation/content/en/books/porters-handbook/security/_index.po:1
/usr/doc/documentation/content/en/books/porters-handbook/special/_index.adoc:1
/usr/doc/documentation/content/en/books/porters-handbook/special/_index.po:1
/usr/doc/documentation/content/es/articles/freebsd-questions/_index.po:4
/usr/doc/documentation/content/es/articles/hubs/_index.po:2
/usr/doc/documentation/content/es/books/handbook/eresources/_index.adoc:1
/usr/doc/documentation/content/es/books/handbook/introduction/_index.adoc:1
/usr/doc/documentation/content/fr/articles/contributing/_index.adoc:1
/usr/doc/documentation/content/fr/books/faq/_index.adoc:12
/usr/doc/documentation/content/fr/books/handbook/mirrors/_index.adoc:2
/usr/doc/documentation/content/hu/books/handbook/firewalls/_index.adoc:6
/usr/doc/documentation/content/hu/books/handbook/mirrors/_index.adoc:1
/usr/doc/documentation/content/ja/books/faq/_index.adoc:4
/usr/doc/documentation/content/ja/books/handbook/mail/_index.adoc:1
/usr/doc/documentation/content/mn/books/handbook/mail/_index.adoc:1
/usr/doc/documentation/content/nl/books/handbook/mirrors/_index.adoc:1
/usr/doc/documentation/content/pl/books/handbook/basics/_index.adoc:1
/usr/doc/documentation/content/pl/books/handbook/desktop/_index.adoc:4
/usr/doc/documentation/content/pl/books/handbook/install/_index.adoc:3
/usr/doc/documentation/content/pl/books/handbook/introduction/_index.adoc:2
/usr/doc/documentation/content/pl/books/handbook/users/_index.adoc:1
/usr/doc/documentation/content/pl/books/handbook/x11/_index.adoc:2
/usr/doc/documentation/content/pt-br/articles/freebsd-questions/_index.adoc:3
/usr/doc/documentation/content/pt-br/articles/freebsd-questions/_index.po:7
/usr/doc/documentation/content/pt-br/articles/hubs/_index.po:2
/usr/doc/documentation/content/pt-br/books/porters-handbook/special/_index.adoc:1
/usr/doc/documentation/content/ru/articles/freebsd-questions/_index.adoc:3
/usr/doc/documentation/content/ru/articles/mailing-list-faq/_index.adoc:1
/usr/doc/documentation/content/ru/books/handbook/eresources/_index.adoc:1
/usr/doc/documentation/content/ru/books/handbook/mail/_index.adoc:1
/usr/doc/documentation/content/ru/books/porters-handbook/security/_index.adoc:1
/usr/doc/documentation/content/ru/books/porters-handbook/special/_index.adoc:1
/usr/doc/documentation/content/zh-cn/articles/contributing/_index.adoc:1
/usr/doc/documentation/content/zh-cn/books/handbook/disks/_index.adoc:1
/usr/doc/documentation/content/zh-cn/books/handbook/mail/_index.adoc:1
/usr/doc/documentation/content/zh-cn/books/handbook/mirrors/_index.adoc:2
/usr/doc/documentation/content/zh-cn/books/porters-handbook/security/_index.adoc:1
/usr/doc/documentation/content/zh-cn/books/porters-handbook/special/_index.adoc:1
/usr/doc/documentation/content/zh-tw/articles/contributing/_index.adoc:1
/usr/doc/documentation/content/zh-tw/articles/freebsd-questions/_index.adoc:3
/usr/doc/documentation/content/zh-tw/articles/hubs/_index.adoc:1
/usr/doc/documentation/content/zh-tw/books/developers-handbook/tools/_index.adoc:1
/usr/doc/documentation/content/zh-tw/books/porters-handbook/security/_index.adoc:1
/usr/doc/documentation/content/zh-tw/books/porters-handbook/special/_index.adoc:1
% 

Website (component in Bugzilla): 

% rg --count --sort path 'WWW:' /usr/doc/website/content
/usr/doc/website/content/en/gnome/contact.adoc:1
/usr/doc/website/content/en/releases/2.1.5R/announce.adoc:1
/usr/doc/website/content/en/releases/2.2.5R/announce.adoc:1
/usr/doc/website/content/en/releases/2.2.6R/announce.adoc:1
/usr/doc/website/content/en/releases/2.2.7R/announce.adoc:1
/usr/doc/website/content/en/releases/2.2.8R/announce.adoc:1
/usr/doc/website/content/en/releases/3.0R/announce.adoc:1
/usr/doc/website/content/en/releases/3.1R/announce.adoc:1
/usr/doc/website/content/en/releases/3.2R/announce.adoc:1
/usr/doc/website/content/en/releases/3.3R/announce.adoc:1
/usr/doc/website/content/en/releases/3.4R/announce.adoc:1
/usr/doc/website/content/en/releases/3.5R/announce.adoc:1
/usr/doc/website/content/en/releases/4.0R/announce.adoc:1
/usr/doc/website/content/en/releases/4.1R/announce.adoc:1
/usr/doc/website/content/en/releases/4.2R/announce.adoc:1
/usr/doc/website/content/en/releases/4.3R/announce.adoc:1
/usr/doc/website/content/en/status/report-2022-07-2022-09/portmgr.adoc:3
/usr/doc/website/content/fr/gnome/contact.adoc:1
% rg --count --sort path 'WWW ' /usr/doc/website/content
/usr/doc/website/content/de/administration.adoc:3
/usr/doc/website/content/en/administration.adoc:4
/usr/doc/website/content/en/cgi/cgi-lib.pl:1
/usr/doc/website/content/en/internal/_index.adoc:1
/usr/doc/website/content/en/internal/about.adoc:2
/usr/doc/website/content/en/status/report-2003-10-2003-12.html:1
/usr/doc/website/content/en/status/report-2006-01-2006-03.html:1
/usr/doc/website/content/en/status/report-2008-07-2008-09.html:1
/usr/doc/website/content/en/status/report-2010-07-2010-09.html:3
/usr/doc/website/content/en/status/report-2022-07-2022-09/doceng.adoc:1
/usr/doc/website/content/en/status/report-2022-07-2022-09/portmgr.adoc:2
/usr/doc/website/content/es/internal/_index.adoc:1
/usr/doc/website/content/es/internal/about.adoc:2
/usr/doc/website/content/es/internal/machines.adoc:1
/usr/doc/website/content/fr/internal/_index.adoc:1
/usr/doc/website/content/fr/internal/about.adoc:2
/usr/doc/website/content/fr/internet.adoc:1
/usr/doc/website/content/hu/administration.adoc:3
/usr/doc/website/content/hu/internet.adoc:2
/usr/doc/website/content/hu/projects/_index.adoc:1
/usr/doc/website/content/ja/internal/_index.adoc:1
/usr/doc/website/content/ja/internal/about.adoc:2
/usr/doc/website/content/ja/mailto.adoc:1
/usr/doc/website/content/ja/news/1997/_index.adoc:3
/usr/doc/website/content/nl/administration.adoc:3
/usr/doc/website/content/nl/internet.adoc:1
/usr/doc/website/content/ru/search/_index.adoc:1
/usr/doc/website/content/zh-cn/mailto.adoc:1
%
Comment 1 Minsoo Choo 2023-11-24 18:43:25 UTC 
https://reviews.freebsd.org/D42759

Past status reports and announcements are excluded.
Port scripts remain the same.

WWW mirrors can be replaced with HTTPS mirrors or Web mirrors. For discussion, please see the review above.
Comment 2 commit-hook freebsd_committer freebsd_triage 2023-11-25 10:42:06 UTC 
A commit in branch main references this bug:

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

commit fbc921a92768ca0cc6276b7685b6563b8fe6cf48
Author:     Minsoo Choo <minsoochoo0122@proton.me>
AuthorDate: 2023-11-25 10:41:15 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2023-11-25 10:41:15 +0000

    Website-Docs: Replace WWW with Web

    PR:                     273247
    Differential Revision:  https://reviews.freebsd.org/D42759

 documentation/content/en/books/handbook/desktop/_index.adoc | 2 +-
 documentation/content/en/books/handbook/mirrors/_index.adoc | 6 +++---
 website/content/en/internal/about.adoc                      | 4 ++--
 3 files changed, 6 insertions(+), 6 deletions(-)
Comment 3 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2023-11-25 10:43:01 UTC 
Fixed, thanks