From 3a73e2a57d6110531255c0d45c295fc1d0204ff4 Mon Sep 17 00:00:00 2001
From: Alexander Ziaee <ziaee@FreeBSD.org>
Date: Tue, 8 Sep 2026 09:12:23 -0400
Subject: [PATCH] docs website: Wordsmith homepage

Wordsmith the docs project website title heading to make it clearer
that this is the docs project portal and not the main website home.
Also, tighten redundant uses of "FreeBSD". Saying it at least once
in every line and heading is quite tedious. Similarily, give the
anchors a more accurate and unique name to ease contribution.

Also tidy grammar on the search bar. Search bars never get punctuation,
unless it's an elipsis, the project uses serial commas, and "in" is not
really correct here.
---
 documentation/themes/beastie/i18n/en.toml              | 10 +++++-----
 .../beastie/layouts/_partials/global-search.html       |  8 ++------
 2 files changed, 7 insertions(+), 11 deletions(-)

diff --git a/documentation/themes/beastie/i18n/en.toml b/documentation/themes/beastie/i18n/en.toml
index e81c8ec297..e7402dc165 100644
--- a/documentation/themes/beastie/i18n/en.toml
+++ b/documentation/themes/beastie/i18n/en.toml
@@ -10,14 +10,14 @@ other = "The FreeBSD Project"
 [freebsd-foundation]
 other = "The FreeBSD Foundation"
 
-[freebsd-documentation]
-other = "FreeBSD Documentation"
+[documentation-portal]
+other = "Documentation Project Portal"
 
-[freebsd-documentation-main-desc]
+[documentation-portal-main-desc]
 other = "FreeBSD is an operating system used to power modern servers, desktops, and embedded platforms."
 
 [global-search-placeholder]
-other = "Search in the articles, books and guides."
+other = "Search the articles, books, and guides"
 
 [toc]
 other = "Table of Contents"
@@ -161,7 +161,7 @@ other = "FreeBSD Handbook"
 other = "A constantly evolving, comprehensive resource for FreeBSD users"
 
 [porters-handbook]
-other = "FreeBSD Porter's Handbook"
+other = "Porter's Handbook"
 
 [porters-handbook-desc]
 other = "A complete reference for the Ports Collection framework"
diff --git a/documentation/themes/beastie/layouts/_partials/global-search.html b/documentation/themes/beastie/layouts/_partials/global-search.html
index 26b3c0db4b..3e604aa5e8 100644
--- a/documentation/themes/beastie/layouts/_partials/global-search.html
+++ b/documentation/themes/beastie/layouts/_partials/global-search.html
@@ -1,11 +1,7 @@
 <section class="welcome-container">
   <div class="title-language-container">
-    <h2>{{ i18n "freebsd-documentation" }}</h2>
-    <a href="#languages" title="Choose language">
-      <img src="{{ absLangURL ($.Site.BaseURL ) }}images/language.png" class="language-image" alt="{{ i18n "choose-language" }}">
-    </a>
-  </div>
-  <p>{{ i18n "freebsd-documentation-main-desc" }}</p>
+    <h2>{{ i18n "documentation-portal" }}</h2>
+  <p>{{ i18n "documentation-portal-main-desc" }}</p>
   {{ $currentLanguage := $.Site.Language }}
   <form class="search" method="get" id="search-form" action="https://docs.freebsd.org/search" name="search-form">
     <input type="hidden" name="DB" value="{{ $currentLanguage }}" />