Bug 273546

Summary: FreeBSD Handbook: descriptiveness, encouragement, etc cetera for people seeking testimonials and the like
Product: Documentation Reporter: Graham Perrin <grahamperrin>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed Not Accepted    
Severity: Affects Some People CC: carlavilla
Priority: --- Keywords: needs-qa
Version: Latest   
Hardware: Any   
OS: Any   
URL: https://github.com/freebsd/freebsd-doc/blob/main/documentation/content/en/books/handbook/introduction/_index.adoc#22-who-uses-freebsd

Description Graham Perrin 2023-09-03 18:28:20 UTC
Paraphrasing a recently received email, from an organisation that sponsored some commits. 

<https://freebsdfoundation.org/freebsd/> under 'Who is Using FreeBSD?', 

> … A more comprehensive list can be found here. …

<https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/nutshell.html#introduction-nutshell-users> redirects to <https://docs.freebsd.org/en/books/handbook/introduction/#nutshell> in the FreeBSD Handbook, 

> Welcome to FreeBSD!

It was not immediately obvious where to find a more complete list of vendors that may be using FreeBSD. 

----

When I dug, today: the link from the FreeBSD Handbook, back to the Foundation site, did find the organisation in a page that someone captured two months ago: <https://web.archive.org/web/2/https://freebsdfoundation.org/about-us/testimonials/>. 

The Project home page does more accurately link to <https://docs.freebsd.org/en/books/handbook/introduction/#introduction-nutshell-users>, 

> Who Uses FreeBSD?

– however, the Project's referring phrase does not do justice to the scope of Foundation-provided testimonials: 

> busiest web sites

Side note: the home page can be improved by, amongst other things, a _direct_ link to testimonials. Some overlap with discreet work in progress on bug 273017. These things should, please, be out of scope for this bug report. 

----

For this report: 

- focus on improving part(s) of the introduction within the Handbook

- take inspiration from <https://freebsdfoundation.org/about-us/testimonials/>

- I can contact someone at the Foundation, with reference to this report.
Comment 1 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2023-09-03 19:29:52 UTC
We decided to leave it at that and let the FreeBSD Foundation take care of this.
Comment 2 Graham Perrin 2023-09-03 20:01:18 UTC
> - I can contact someone at the Foundation, with reference to this report.

Already done, for anyone who might have been interested.