From: Maxim <glokaya@kuzdra.org>
Subject: www: Add and fix cross-references
To: tech@openbsd.org
Date: Sat, 14 Dec 2024 13:14:23 +0100

M  build/mirrors/anoncvs.html.head  |  10+  8-
M  faq/faq1.html                    |   3+  4-
M  faq/faq10.html                   |   3+  2-
M  faq/faq5.html                    |   3+  2-
M  stable.html                      |   1+  1-

5 files changed, 20 insertions(+), 17 deletions(-)

commit - e3272426f54a4d2499eb7f8a027ddc424b09f14e
commit + 645d1e810340af0d4ebed6977dffbec127b77b63
blob - 6ec2f6e8293d6d8863c776d07a9d503baa53c0ea
blob + 1504eb5d623751f79f26505675f48d3f7784a062
--- build/mirrors/anoncvs.html.head
+++ build/mirrors/anoncvs.html.head
@@ -41,7 +41,8 @@ The OpenBSD Project currently has four active source r
   <li><b>src</b> - source code for the base system
   <li><b>ports</b> - the <a href="faq/ports">ports tree</a>
   <li><b>www</b> - web pages
-  <li><b>xenocara</b> - xenocara
+  <li><b>xenocara</b> -
+    the <a href="https://xenocara.org">OpenBSD's version of X</a>
 </ul>
 
 <h3 id="CVS">What is CVS?</h3>
@@ -78,9 +79,9 @@ The kernel sources are in <code>sys.tar.gz</code> and 
 are in <code>src.tar.gz</code>.
 
 <p>
-The following commands assume you have followed
-<a href="faq/faq5.html#wsrc">these instructions</a> to give a non-root
-user write access to the src, ports and xenocara directories.
+The following commands assume you have followed instructions to
+<a href="faq/faq5.html#wsrc">give a non-root user write access</a>
+to the src, ports and xenocara directories.
 
 <pre class="cmdbox">
 $ <b>cd /usr/src</b>
@@ -97,13 +98,14 @@ $ <b>tar xzf /tmp/xenocara.tar.gz</b>
 <p>
 <a href="https://man.openbsd.org/cvs">cvs(1)</a> was designed to be a simple way
 to retrieve and update your sources.
-You must first decide whether you want to track -current or a
-<a href="stable.html">-stable</a> branch.
+You must first decide whether you want to track
+<a href="faq/current.html">-current</a>
+or a <a href="stable.html">-stable</a> branch.
 The current tree has all of the up to the minute changes, whereas the
 -stable branch contains the sources for the release plus the patches from
 the <a href="errata.html">errata</a> and lesser issues already applied.
-For more information on the flavors of OpenBSD, see
-<a href="faq/faq5.html#Flavors">here</a>.
+There is also an FAQ on the
+<a href="faq/faq5.html#Flavors">flavors of OpenBSD</a>.
 
 <p>
 Choose the Anonymous CVS server you are going to use from the
blob - ff8043a8fe691217edaa4b9e14e6d8aa3e8953b0
blob + 5966ac2206a2d34f3db890b9e277d778cba06f21
--- faq/faq1.html
+++ faq/faq1.html
@@ -68,8 +68,7 @@ The binaries are free.
 The source is free.
 All parts of OpenBSD have reasonable copyright terms permitting free
 redistribution.
-More about OpenBSD's copyright policy can be found
-<a href="../policy.html">here</a>.
+See <a href="../policy.html">OpenBSD's copyright policy</a> to learn more.
 
 <p>
 The maintainers of OpenBSD support the project largely from their own pockets.
@@ -116,8 +115,8 @@ by any person anywhere in the world for any purpose.
 
 The OpenBSD team makes a new release approximately every six months, with the
 target release dates in May and November.
-More information on the development cycle can be found
-<a href="faq5.html#Flavors">here</a>.
+Read the FAQ section <a href="faq5.html#Flavors">OpenBSD's flavors</a>
+to learn more about the development cycle.
 
 <h2 id="Platforms">Hardware Support</h2>
 
blob - e55881164d3528cb3ebd257c0bfdecb3663a05c4
blob + 80c8f01a84af0bdc39af8ee1dbe6431af9ecf742
--- faq/faq10.html
+++ faq/faq10.html
@@ -44,8 +44,9 @@ FAQ - System Management
 
 <h2 id="Patches">Security Updates</h2>
 
-When a critical bug is found, the fix will be committed to the -current tree
-(and made available in <a href="faq5.html#Flavors">snapshot builds</a>)
+When a critical bug is found, the fix will be committed to the
+<a href="current.html">-current</a> tree
+(and made available in <a href="faq5.html#Snapshots">snapshot builds</a>)
 as soon as possible.
 It will then be backported to the two most recent OpenBSD releases in the
 form of <a href="../errata.html">errata</a> and details will be sent to the
blob - 3024b80b6670e400bdb381304449f438bfd26bd8
blob + 5b935e0b4edbc39bb1fe679aedc99ed274a5d9ee
--- faq/faq5.html
+++ faq/faq5.html
@@ -40,9 +40,10 @@ There are three flavors of OpenBSD:
 
 <ul>
   <li><b>releases:</b> The version of OpenBSD shipped every six months.
-  <li><b>-current:</b> The development branch.
+  <li><b><a href="current.html">-current</a>:</b> The development branch.
       Every six months, -current is tagged and becomes the next release.
-  <li><b>-stable:</b> A release plus patches found on the
+  <li><b><a href="../stable.html">-stable</a>:</b>
+      A release plus patches found on the
       <a href="../errata.html">errata page</a>.
       When very important fixes are made to -current, they are backported
       to the supported -stable branches.
blob - 1cd276f3fdd5c81bd2038a3612d4649b1094b579
blob + 6093ca997aa221cb9a49f3a4697e806e6e977790
--- stable.html
+++ stable.html
@@ -42,7 +42,7 @@ from source.
 If you're running a release on amd64, i386, or arm64, you can also
 use the <a href="https://man.openbsd.org/syspatch">syspatch(8)</a> utility to
 upgrade any files in need of security or reliability fixes with binary updates.
-More information can be found <a href="faq/faq10.html#Patches">here</a>.
+Read about <a href="faq/faq10.html#Patches">security updates</a> for more details.
 
 <h3 id="getting">Getting -stable Source Code</h3>