From owner-dev-commits-doc-all@freebsd.org Sun May 2 17:10:58 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 2979F62AEFE for ; Sun, 2 May 2021 17:10:58 +0000 (UTC) (envelope-from carlavilla@freebsd.org) Received: from smtp.freebsd.org (smtp.freebsd.org [96.47.72.83]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "smtp.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4FYCLB0bmDz4rQT; Sun, 2 May 2021 17:10:58 +0000 (UTC) (envelope-from carlavilla@freebsd.org) Received: from mail-ed1-f46.google.com (mail-ed1-f46.google.com [209.85.208.46]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "GTS CA 1O1" (verified OK)) (Authenticated sender: carlavilla) by smtp.freebsd.org (Postfix) with ESMTPSA id E5124DE4B; Sun, 2 May 2021 17:10:57 +0000 (UTC) (envelope-from carlavilla@freebsd.org) Received: by mail-ed1-f46.google.com with SMTP id j28so3679576edy.9; Sun, 02 May 2021 10:10:57 -0700 (PDT) X-Gm-Message-State: AOAM532dTVGMltak7hjeNbC19OHOPIfFe0w+ZkF5pRSOI/jd/5/gIF/d Ah0F7vsO0FBg+Ehy8JHq5Rf8EEhLtgW8Ux+2oDU= X-Google-Smtp-Source: ABdhPJwTfgtcI69uGwFKD3QmOJYcOc1qP1sjnLY6dW41b/vhFCsEhmefK5cH5qVFcfjj+uxMB6CvTr916oJhxDPXl80= X-Received: by 2002:aa7:c34b:: with SMTP id j11mr16630838edr.188.1619975456216; Sun, 02 May 2021 10:10:56 -0700 (PDT) MIME-Version: 1.0 References: <202105021654.142GsST9055413@gitrepo.freebsd.org> In-Reply-To: <202105021654.142GsST9055413@gitrepo.freebsd.org> From: Sergio Carlavilla Date: Sun, 2 May 2021 19:10:44 +0200 X-Gmail-Original-Message-ID: Message-ID: Subject: Re: git: 2c5bff688d - main - Improve descriptions for some books and articles To: Allan Jude Cc: doc-committers@freebsd.org, dev-commits-doc-all@freebsd.org Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 02 May 2021 17:10:58 -0000 On Sun, 2 May 2021 at 18:54, Allan Jude wrote: > > The branch main has been updated by allanjude: > > URL: https://cgit.FreeBSD.org/doc/commit/?id=3D2c5bff688d8653c4306a2f6fdb= b2c966eaee5a1c > > commit 2c5bff688d8653c4306a2f6fdbb2c966eaee5a1c > Author: Allan Jude > AuthorDate: 2021-05-02 16:10:56 +0000 > Commit: Allan Jude > CommitDate: 2021-05-02 16:53:24 +0000 > > Improve descriptions for some books and articles > > Also add weights to some, to define the sort order in the index > Put the more commonly used items at the top of their respective lists > > The improved descriptions were taken from the old books/articles list= : > https://www.freebsd.org/docs/books/ > > Sponsored-By: Klara Inc. > --- > .../content/en/articles/building-products/_index.adoc | 2 +- > .../content/en/articles/committers-guide/_index.adoc | 3 ++- > documentation/content/en/articles/contributing/_index.adoc | 3 ++- > documentation/content/en/articles/contributors/_index.adoc | 2 +- > .../content/en/articles/filtering-bridges/_index.adoc | 2 +- > documentation/content/en/articles/fonts/_index.adoc | 2 +- > documentation/content/en/articles/freebsd-releng/_index.adoc | 2 +- > .../content/en/articles/freebsd-update-server/_index.adoc | 2 +- > documentation/content/en/articles/geom-class/_index.adoc | 2 +- > documentation/content/en/articles/hubs/_index.adoc | 2 +- > documentation/content/en/articles/leap-seconds/_index.adoc | 2 +- > .../content/en/articles/linux-emulation/_index.adoc | 2 +- > .../content/en/articles/mailing-list-faq/_index.adoc | 2 +- > documentation/content/en/articles/pam/_index.adoc | 2 +- > .../content/en/articles/problem-reports/_index.adoc | 2 +- > documentation/content/en/articles/rc-scripting/_index.adoc | 2 +- > documentation/content/en/articles/releng/_index.adoc | 4 ++-- > documentation/content/en/articles/remote-install/_index.adoc | 2 +- > documentation/content/en/articles/serial-uart/_index.adoc | 2 +- > documentation/content/en/articles/solid-state/_index.adoc | 2 +- > documentation/content/en/articles/vm-design/_index.adoc | 2 +- > documentation/content/en/books/arch-handbook/_index.adoc | 3 ++- > documentation/content/en/books/design-44bsd/_index.adoc | 3 ++- > documentation/content/en/books/dev-model/_index.adoc | 3 ++- > .../content/en/books/developers-handbook/_index.adoc | 3 ++- > documentation/content/en/books/faq/_index.adoc | 3 ++- > documentation/content/en/books/fdp-primer/_index.adoc | 3 ++- > documentation/content/en/books/handbook/_index.adoc | 3 ++- > documentation/content/en/books/porters-handbook/_index.adoc | 3 ++- > documentation/themes/beastie/layouts/index.html | 12 ++++++= ++---- > 30 files changed, 48 insertions(+), 34 deletions(-) > > diff --git a/documentation/content/en/articles/building-products/_index.a= doc b/documentation/content/en/articles/building-products/_index.adoc > index 577b1d3d42..6c9a001278 100644 > --- a/documentation/content/en/articles/building-products/_index.adoc > +++ b/documentation/content/en/articles/building-products/_index.adoc > @@ -5,7 +5,7 @@ authors: > email: jkoshy@FreeBSD.org > organizations: > - organization: The FreeBSD Project > -description: Building Products with FreeBSD > +description: How FreeBSD can help you build a better product > trademarks: ["freebsd", "general"] > --- > > diff --git a/documentation/content/en/articles/committers-guide/_index.ad= oc b/documentation/content/en/articles/committers-guide/_index.adoc > index 7aad6a68ef..13cbb0c6a2 100644 > --- a/documentation/content/en/articles/committers-guide/_index.adoc > +++ b/documentation/content/en/articles/committers-guide/_index.adoc > @@ -3,8 +3,9 @@ title: Committer's Guide > authors: > - author: The FreeBSD Documentation Project > copyright: 1999-2021 The FreeBSD Documentation Project > -description: FreeBSD Committer's Guide > +description: Introductory information for FreeBSD committers > trademarks: ["freebsd", "coverity", "ibm", "intel", "general"] > +weight: 25 > --- > > =3D Committer's Guide > diff --git a/documentation/content/en/articles/contributing/_index.adoc b= /documentation/content/en/articles/contributing/_index.adoc > index c7d61004ec..6dab1d5096 100644 > --- a/documentation/content/en/articles/contributing/_index.adoc > +++ b/documentation/content/en/articles/contributing/_index.adoc > @@ -4,8 +4,9 @@ authors: > - author: Jordan Hubbard > - author: Sam Lawrance > - author: Mark Linimon > -description: Contributing to the FreeBSD Project > +description: How to contribute to the FreeBSD Project > trademarks: ["freebsd", "ieee", "general"] > +weight: 15 > --- > > =3D Contributing to FreeBSD > diff --git a/documentation/content/en/articles/contributors/_index.adoc b= /documentation/content/en/articles/contributors/_index.adoc > index afd0f120b4..fecc0e6fe6 100644 > --- a/documentation/content/en/articles/contributors/_index.adoc > +++ b/documentation/content/en/articles/contributors/_index.adoc > @@ -1,6 +1,6 @@ > --- > title: Contributors to FreeBSD > -description: Contributors to FreeBSD > +description: A list of organizations and individuals who have contribute= d to FreeBSD > trademarks: ["freebsd", "sun", "general"] > --- > > diff --git a/documentation/content/en/articles/filtering-bridges/_index.a= doc b/documentation/content/en/articles/filtering-bridges/_index.adoc > index 7a3647c0fb..9ae472d44e 100644 > --- a/documentation/content/en/articles/filtering-bridges/_index.adoc > +++ b/documentation/content/en/articles/filtering-bridges/_index.adoc > @@ -3,7 +3,7 @@ title: Filtering Bridges > authors: > - author: Alex Dupre > email: ale@FreeBSD.org > -description: Filtering Bridges in FreeBSD > +description: Configuring firewalls and filtering on FreeBSD hosts acting= as bridges rather than routers > trademarks: ["freebsd", "3com", "intel", "general"] > --- > > diff --git a/documentation/content/en/articles/fonts/_index.adoc b/docume= ntation/content/en/articles/fonts/_index.adoc > index 70e52a1a91..34b12ba906 100644 > --- a/documentation/content/en/articles/fonts/_index.adoc > +++ b/documentation/content/en/articles/fonts/_index.adoc > @@ -4,7 +4,7 @@ subtitle: A Tutorial > authors: > - author: Dave Bodenstab > email: imdave@synet.net > -description: Description of the various font files that may be used with= FreeBSD > +description: A description of the various font technologies in FreeBSD, = and how to use them with different programs > trademarks: ["freebsd", "adobe", "apple", "linux", "microsoft", "opengro= up", "general"] > --- > > diff --git a/documentation/content/en/articles/freebsd-releng/_index.adoc= b/documentation/content/en/articles/freebsd-releng/_index.adoc > index 5615986124..bbb3f86ff9 100644 > --- a/documentation/content/en/articles/freebsd-releng/_index.adoc > +++ b/documentation/content/en/articles/freebsd-releng/_index.adoc > @@ -8,7 +8,7 @@ organizations: > webpage: https://www.freebsdfoundation.org/ > - organization: Rubicon Communications, LLC (Netgate) > webpage: https://www.netgate.com/ > -description: FreeBSD Release Engineering > +description: Describes the approach used by the FreeBSD release engineer= ing team to make production quality releases of the FreeBSD Operating Syste= m. It describes the tools available for those interested in producing custo= mized FreeBSD releases for corporate rollouts or commercial productization > trademarks: ["freebsd", "intel", "general"] > --- > > diff --git a/documentation/content/en/articles/freebsd-update-server/_ind= ex.adoc b/documentation/content/en/articles/freebsd-update-server/_index.ad= oc > index 6ee32d4eee..527067e752 100644 > --- a/documentation/content/en/articles/freebsd-update-server/_index.adoc > +++ b/documentation/content/en/articles/freebsd-update-server/_index.adoc > @@ -4,7 +4,7 @@ authors: > - author: Jason Helfman > email: jgh@FreeBSD.org > copyright: 2009-2011, 2013 Jason Helfman > -description: Build Your Own FreeBSD Update Server > +description: Building your own freebsd-update server allows a system adm= inistrator to perform fast updates for a number of machines from a local mi= rror > trademarks: ["freebsd", "amd", "intel", "general"] > --- > > diff --git a/documentation/content/en/articles/geom-class/_index.adoc b/d= ocumentation/content/en/articles/geom-class/_index.adoc > index 8c93697afb..902720e465 100644 > --- a/documentation/content/en/articles/geom-class/_index.adoc > +++ b/documentation/content/en/articles/geom-class/_index.adoc > @@ -3,7 +3,7 @@ title: Writing a GEOM Class > authors: > - author: Ivan Voras > email: ivoras@FreeBSD.org > -description: Writing a GEOM Class in FreeBSD > +description: A guide to GEOM internals, and writing your own GEOM class > trademarks: ["freebsd", "intel", "general"] > --- > > diff --git a/documentation/content/en/articles/hubs/_index.adoc b/documen= tation/content/en/articles/hubs/_index.adoc > index 3819b76d71..55f3b50f0e 100644 > --- a/documentation/content/en/articles/hubs/_index.adoc > +++ b/documentation/content/en/articles/hubs/_index.adoc > @@ -9,7 +9,7 @@ authors: > email: dl@leo.org > - author: Ken Smith > email: kensmith@FreeBSD.org > -description: How to mirror FreeBSD > +description: The all in one guide for mirroring the FreeBSD website, FTP= servers, and more > trademarks: ["freebsd", "general"] > --- > > diff --git a/documentation/content/en/articles/leap-seconds/_index.adoc b= /documentation/content/en/articles/leap-seconds/_index.adoc > index 8ad3c6154e..9dc11b3483 100644 > --- a/documentation/content/en/articles/leap-seconds/_index.adoc > +++ b/documentation/content/en/articles/leap-seconds/_index.adoc > @@ -1,6 +1,6 @@ > --- > title: FreeBSD Support for Leap Seconds > -description: FreeBSD Support for Leap Seconds > +description: A short description of how leap seconds are handled on Free= BSD > --- > > =3D FreeBSD Support for Leap Seconds > diff --git a/documentation/content/en/articles/linux-emulation/_index.ado= c b/documentation/content/en/articles/linux-emulation/_index.adoc > index 701bf524cc..d5c6d985ed 100644 > --- a/documentation/content/en/articles/linux-emulation/_index.adoc > +++ b/documentation/content/en/articles/linux-emulation/_index.adoc > @@ -3,7 +3,7 @@ title: Linux=C2=AE emulation in FreeBSD > authors: > - author: Roman Divacky > email: rdivacky@FreeBSD.org > -description: Linux=C2=AE emulation in FreeBSD > +description: A technical description about the internals of the Linux em= ulation layer in FreeBSD > trademarks: ["freebsd", "ibm", "adobe", "netbsd", "realnetworks", "oracl= e", "linux", "sun", "general"] > --- > > diff --git a/documentation/content/en/articles/mailing-list-faq/_index.ad= oc b/documentation/content/en/articles/mailing-list-faq/_index.adoc > index 81bb9f2b07..f5b4eb064d 100644 > --- a/documentation/content/en/articles/mailing-list-faq/_index.adoc > +++ b/documentation/content/en/articles/mailing-list-faq/_index.adoc > @@ -3,7 +3,7 @@ title: Frequently Asked Questions About The FreeBSD Maili= ng Lists > authors: > - author: The FreeBSD Documentation Project > copyright: 2004-2021 The FreeBSD Documentation Project > -description: Frequently Asked Questions About The FreeBSD Mailing Lists > +description: How to best use the mailing lists, such as how to help avoi= d frequently-repeated discussions > --- > > =3D Frequently Asked Questions About The FreeBSD Mailing Lists > diff --git a/documentation/content/en/articles/pam/_index.adoc b/document= ation/content/en/articles/pam/_index.adoc > index 6f3d5a22d6..03672f1ba2 100644 > --- a/documentation/content/en/articles/pam/_index.adoc > +++ b/documentation/content/en/articles/pam/_index.adoc > @@ -3,7 +3,7 @@ title: Pluggable Authentication Modules > authors: > - author: Dag-Erling Sm=C3=B8rgrav > copyright: 2001-2003 Networks Associates Technology, Inc. > -description: Pluggable Authentication Modules (PAM) in FreeBSD > +description: A guide to the PAM system and modules under FreeBSD > trademarks: ["pam", "freebsd", "linux", "opengroup", "sun", "general"] > --- > > diff --git a/documentation/content/en/articles/problem-reports/_index.ado= c b/documentation/content/en/articles/problem-reports/_index.adoc > index d61055bdfc..ac334b78b4 100644 > --- a/documentation/content/en/articles/problem-reports/_index.adoc > +++ b/documentation/content/en/articles/problem-reports/_index.adoc > @@ -3,7 +3,7 @@ title: Writing FreeBSD Problem Reports > authors: > - author: Dag-Erling Sm=C3=B8rgrav > - author: Mark Linimon > -description: Writing FreeBSD Problem Reports > +description: How to best formulate and submit a problem report to the Fr= eeBSD Project > trademarks: ["freebsd", "ibm", "intel", "sun", "general"] > --- > > diff --git a/documentation/content/en/articles/rc-scripting/_index.adoc b= /documentation/content/en/articles/rc-scripting/_index.adoc > index 72e71bffbd..50507c8412 100644 > --- a/documentation/content/en/articles/rc-scripting/_index.adoc > +++ b/documentation/content/en/articles/rc-scripting/_index.adoc > @@ -4,7 +4,7 @@ authors: > - author: Yar Tikhiy > email: yar@FreeBSD.org > copyright: 2005-2006, 2012 The FreeBSD Project > -description: Practical rc.d scripting in BSD > +description: A guide to writing new rc.d scripts and understanding those= already written > trademarks: ["freebsd", "netbsd", "general"] > --- > > diff --git a/documentation/content/en/articles/releng/_index.adoc b/docum= entation/content/en/articles/releng/_index.adoc > index 665c3cea45..ef1c6c5035 100644 > --- a/documentation/content/en/articles/releng/_index.adoc > +++ b/documentation/content/en/articles/releng/_index.adoc > @@ -1,10 +1,10 @@ > --- > -title: FreeBSD Release Engineering > +title: Legacy FreeBSD Release Engineering > authors: > - author: Murray Stokely > email: murray@FreeBSD.org > webpage: https://people.FreeBSD.org/~murray/ > -description: This paper describes the approach used by the FreeBSD relea= se engineering team to make production quality releases of the FreeBSD Oper= ating System > +description: This paper describes the approach used by past the FreeBSD = release engineering team to make production quality releases of the FreeBSD= Operating System > trademarks: ["freebsd", "intel", "general"] > --- > > diff --git a/documentation/content/en/articles/remote-install/_index.adoc= b/documentation/content/en/articles/remote-install/_index.adoc > index e5343b75a9..03d62cad6a 100644 > --- a/documentation/content/en/articles/remote-install/_index.adoc > +++ b/documentation/content/en/articles/remote-install/_index.adoc > @@ -4,7 +4,7 @@ authors: > - author: Daniel Gerzo > email: danger@FreeBSD.org > copyright: 2008-2021 The FreeBSD Documentation Project > -description: Remote Installation of the FreeBSD Operating System Without= a Remote Console > +description: Describes the remote installation of the FreeBSD operating = system when the console of the remote system is unavailable > trademarks: ["freebsd", "general"] > --- > > diff --git a/documentation/content/en/articles/serial-uart/_index.adoc b/= documentation/content/en/articles/serial-uart/_index.adoc > index 9bd53781e0..4a9d5b783f 100644 > --- a/documentation/content/en/articles/serial-uart/_index.adoc > +++ b/documentation/content/en/articles/serial-uart/_index.adoc > @@ -3,7 +3,7 @@ title: Serial and UART Tutorial > authors: > - author: Frank Durda > email: uhclem@FreeBSD.org > -description: How to use serial hardware and UART with FreeBSD > +description: Detailed information about the use of serial ports and UART= with FreeBSD > trademarks: ["freebsd", "microsoft", "general"] > --- > > diff --git a/documentation/content/en/articles/solid-state/_index.adoc b/= documentation/content/en/articles/solid-state/_index.adoc > index 4a1b022fdb..7238aa8dad 100644 > --- a/documentation/content/en/articles/solid-state/_index.adoc > +++ b/documentation/content/en/articles/solid-state/_index.adoc > @@ -4,7 +4,7 @@ authors: > - author: John Kozubik > email: john@kozubik.com > copyright: 2001 - 2021 The FreeBSD Documentation Project > -description: FreeBSD and Solid State Devices > +description: The use of solid state disk devices in FreeBSD > trademarks: ["freebsd", "general"] > --- > > diff --git a/documentation/content/en/articles/vm-design/_index.adoc b/do= cumentation/content/en/articles/vm-design/_index.adoc > index 12a60f6962..884e88bd76 100644 > --- a/documentation/content/en/articles/vm-design/_index.adoc > +++ b/documentation/content/en/articles/vm-design/_index.adoc > @@ -3,7 +3,7 @@ title: Design elements of the FreeBSD VM system > authors: > - author: Matthew Dillon > email: dillon@apollo.backplane.com > -description: Design elements of the FreeBSD VM system > +description: An easy to follow description of the design of the FreeBSD = virtual memory system > trademarks: ["freebsd", "linux", "microsoft", "opengroup", "daemon-news"= , "general"] > --- > > diff --git a/documentation/content/en/books/arch-handbook/_index.adoc b/d= ocumentation/content/en/books/arch-handbook/_index.adoc > index a5cefc4616..59041a32d6 100644 > --- a/documentation/content/en/books/arch-handbook/_index.adoc > +++ b/documentation/content/en/books/arch-handbook/_index.adoc > @@ -3,9 +3,10 @@ title: FreeBSD Architecture Handbook > authors: > - author: The FreeBSD Documentation Project > copyright: Copyright =C2=A9 2000-2006, 2012-2021 The FreeBSD Documentati= on Project > -description: FreeBSD Architecture Handbook Index > +description: For FreeBSD system developers. This book covers the archite= ctural details of many important FreeBSD kernel subsystems > trademarks: ["freebsd", "apple", "microsoft", "unix", "general"] > next: books/arch-handbook/parti > +weight: 50 > --- > > =3D FreeBSD Architecture Handbook > diff --git a/documentation/content/en/books/design-44bsd/_index.adoc b/do= cumentation/content/en/books/design-44bsd/_index.adoc > index bab937e2fc..596a138529 100644 > --- a/documentation/content/en/books/design-44bsd/_index.adoc > +++ b/documentation/content/en/books/design-44bsd/_index.adoc > @@ -6,8 +6,9 @@ authors: > - author: Michael J. Karels > - author: John S. Quarterman > copyright: 1996 Addison-Wesley Longman, Inc > -description: The Design and Implementation of the 4.4BSD Operating Syste= m. Second chapter. > +description: Donated by Addison-Wesley, provides a design overview of 4.= 4BSD, from which FreeBSD was originally derived > trademarks: ["design-44bsd"] > +weight: 60 > --- > > =3D The Design and Implementation of the 4.4BSD Operating System > diff --git a/documentation/content/en/books/dev-model/_index.adoc b/docum= entation/content/en/books/dev-model/_index.adoc > index c5b4061159..8d3b9ed4db 100644 > --- a/documentation/content/en/books/dev-model/_index.adoc > +++ b/documentation/content/en/books/dev-model/_index.adoc > @@ -3,8 +3,9 @@ title: A project model for the FreeBSD Project > authors: > - author: Niklas Saers > copyright: Copyright =C2=A9 2002-2005 Niklas Saers > -description: A project model for the FreeBSD Project > +description: A formal study of the organization of the FreeBSD project > trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "micro= soft", "opengroup", "sun", "netbsd", "general"] > +weight: 45 > --- > > =3D A project model for the FreeBSD Project > diff --git a/documentation/content/en/books/developers-handbook/_index.ad= oc b/documentation/content/en/books/developers-handbook/_index.adoc > index c7407e78d1..30c5d158f8 100644 > --- a/documentation/content/en/books/developers-handbook/_index.adoc > +++ b/documentation/content/en/books/developers-handbook/_index.adoc > @@ -3,9 +3,10 @@ title: FreeBSD Developers' Handbook > authors: > - author: The FreeBSD Documentation Project > copyright: 1995-2021 The FreeBSD Documentation Project > -description: FreeBSD Developers' Handbook Index > +description: For people who want to develop software for FreeBSD (and no= t just people who are developing FreeBSD itself) > trademarks: ["freebsd", "apple", "ibm", "ieee", "intel", "linux", "micro= soft", "opengroup", "sun", "general"] > next: books/developers-handbook/parti > +weight: 25 > --- > > =3D FreeBSD Developers' Handbook > diff --git a/documentation/content/en/books/faq/_index.adoc b/documentati= on/content/en/books/faq/_index.adoc > index cf3d7379df..70690a9837 100644 > --- a/documentation/content/en/books/faq/_index.adoc > +++ b/documentation/content/en/books/faq/_index.adoc > @@ -3,8 +3,9 @@ title: Frequently Asked Questions for FreeBSD 11.X, 12.X,= and 13.X > authors: > - author: The FreeBSD Documentation Project > copyright: 1995-2021 The FreeBSD Documentation Project > -description: Frequently Asked Questions (FAQ) for FreeBSD 11.X, 12.X, an= d 13.X > +description: Frequently Asked Questions, and answers, covering all aspec= ts of FreeBSD > trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "micro= soft", "opengroup", "sun", "netbsd", "general"] > +weight: 5 > --- > > =3D Frequently Asked Questions for FreeBSD {rel2-relx} and {rel-relx} > diff --git a/documentation/content/en/books/fdp-primer/_index.adoc b/docu= mentation/content/en/books/fdp-primer/_index.adoc > index 403e249f11..fb703561d5 100644 > --- a/documentation/content/en/books/fdp-primer/_index.adoc > +++ b/documentation/content/en/books/fdp-primer/_index.adoc > @@ -4,8 +4,9 @@ authors: > - author: The FreeBSD Documentation Project > copyright: 1998-2021 DocEng > trademarks: ["general"] > -description: FreeBSD Documentation Project Primer for New Contributors I= ndex > +description: Everything you need to know in order to start contributing = to the FreeBSD Documentation Project > next: books/fdp-primer/preface > +weight: 10 > --- > > =3D FreeBSD Documentation Project Primer for New Contributors > diff --git a/documentation/content/en/books/handbook/_index.adoc b/docume= ntation/content/en/books/handbook/_index.adoc > index 0fdd49727d..f1f246dd93 100644 > --- a/documentation/content/en/books/handbook/_index.adoc > +++ b/documentation/content/en/books/handbook/_index.adoc > @@ -3,9 +3,10 @@ title: FreeBSD Handbook > authors: > - author: The FreeBSD Documentation Project > copyright: 1995-2021 The FreeBSD Documentation Project > -description: FreeBSD Handbook Index > +description: A constantly evolving, comprehensive resource for FreeBSD u= sers > trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple= ", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "orac= le", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilog= ic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree= 86", "general"] > next: books/handbook/preface > +weight: 1 > --- > > =3D FreeBSD Handbook > diff --git a/documentation/content/en/books/porters-handbook/_index.adoc = b/documentation/content/en/books/porters-handbook/_index.adoc > index 60a9df7f8a..a82db8f052 100644 > --- a/documentation/content/en/books/porters-handbook/_index.adoc > +++ b/documentation/content/en/books/porters-handbook/_index.adoc > @@ -3,9 +3,10 @@ title: FreeBSD Porter's Handbook > authors: > - author: The FreeBSD Documentation Project > copyright: 2000-2021 The FreeBSD Documentation Project > -description: FreeBSD Porter's Handbook Index > +description: Essential reading if you plan on providing a port of a thir= d party piece of software > trademarks: ["freebsd", "sun", "unix", "general"] > next: books/porters-handbook/porting-why > +weight: 15 > --- > > =3D FreeBSD Porter's Handbook > diff --git a/documentation/themes/beastie/layouts/index.html b/documentat= ion/themes/beastie/layouts/index.html > index 1ba57c710a..8b56f7c484 100644 > --- a/documentation/themes/beastie/layouts/index.html > +++ b/documentation/themes/beastie/layouts/index.html > @@ -30,11 +30,13 @@ > {{ end }} > >
    > - {{ range sort $books "path" }} > + {{ range sort $books "weight" "path" }} > {{ if in .path "_index.adoc" }} > {{ $bookPath :=3D replaceRE "/_index.adoc" "" .path }} > {{ $bookName :=3D replaceRE "books/" "" $bookPath }} > -
  • {{ .page.Title }}
    • > +
  • {{ .page.Title }} > +

    {{ .page.Params.description }}

    > +
    • > {{ end }} > {{ end }} >
> @@ -50,11 +52,13 @@ > {{ end }} > >
    > - {{ range sort $articles "path" }} > + {{ range sort $articles "weight" "path" }} > {{ if in .path "_index.adoc" }} > {{ $articlePath :=3D replaceRE "/_index.adoc" "" .path }} > {{ $articleName :=3D replaceRE "articles/" "" $articlePath }} > -
  • {{ .page.Title }}
    • > +
  • {{ .page.Title }} > +

    {{ .page.Params.description }}

    > +
    • > {{ end }} > {{ end }} >
Uo! Really nice! Thanks for that! I'm preparing the tags too :)