1 files changed, 28 insertions, 78 deletions
diff --git a/documentation/content/en/books/developers-handbook/introduction/_index.adoc b/documentation/content/en/books/developers-handbook/introduction/_index.adoc
index 35e8e65fca..29f1dbdd5f 100644
--- a/documentation/content/en/books/developers-handbook/introduction/_index.adoc
+++ b/documentation/content/en/books/developers-handbook/introduction/_index.adoc
@@ -7,6 +7,9 @@ prev: books/developers-handbook/parti
 next: books/developers-handbook/tools
 description: Introduction to the FreeBSD Developers Handbook
 tags: ["introduction", "Developing on FreeBSD", "BSD Vision", "Architectural Guidelines"]
+showBookMenu: true
+weight: 2
+path: "/books/developers-handbook/introduction/"
 ---
 
 [[introduction]]
@@ -17,22 +20,35 @@ tags: ["introduction", "Developing on FreeBSD", "BSD Vision", "Architectural Gui
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
 :source-highlighter: rouge
 :experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
+:images-path: books/developers-handbook/
 
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
 include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
 include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
 
+ifndef::env-beastie[]
 toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
 
 [[introduction-devel]]
 == Developing on FreeBSD
@@ -70,72 +86,6 @@ From Scheifler & Gettys: "X Window System"
 [[introduction-layout]]
 == The Layout of /usr/src
 
-The complete source code to FreeBSD is available from our public repository.
-The source code is normally installed in [.filename]#/usr/src# which contains the following subdirectories:
-
-[.informaltable]
-[cols="1,1", frame="none", options="header"]
-|===
-| Directory
-| Description
-
-|[.filename]#bin/#
-|Source for files in [.filename]#/bin#
-
-|[.filename]#cddl/#
-|Utilities covered by the Common Development and Distribution License
-
-|[.filename]#contrib/#
-|Source for files from contributed software
-
-|[.filename]#crypto/#
-|Cryptographical sources
-
-|[.filename]#etc/#
-|Source for files in [.filename]#/etc#
-
-|[.filename]#gnu/#
-|Utilities covered by the GNU Public License
-
-|[.filename]#include/#
-|Source for files in [.filename]#/usr/include#
-
-|[.filename]#kerberos5/#
-|Source for Kerberos version 5
-
-|[.filename]#lib/#
-|Source for files in [.filename]#/usr/lib#
-
-|[.filename]#libexec/#
-|Source for files in [.filename]#/usr/libexec#
-
-|[.filename]#release/#
-|Files required to produce a FreeBSD release
-
-|[.filename]#rescue/#
-|Build system for the [.filename]#/rescue# utilities
-
-|[.filename]#sbin/#
-|Source for files in [.filename]#/sbin#
-
-|[.filename]#secure/#
-|Contributed cryptographic sources
-
-|[.filename]#share/#
-|Source for files in [.filename]#/usr/share#
-
-|[.filename]#sys/#
-|Kernel source files
-
-|[.filename]#tests/#
-|The FreeBSD test suite
-
-|[.filename]#tools/#
-|Tools used for maintenance and testing of FreeBSD
-
-|[.filename]#usr.bin/#
-|Source for files in [.filename]#/usr/bin#
-
-|[.filename]#usr.sbin/#
-|Source for files in [.filename]#/usr/sbin#
-|===
+The complete source code for FreeBSD is available from our link:https://cgit.freebsd.org/src/[public Git repository].
+The source code is normally installed in [.filename]#/usr/src#.
+The layout of the source tree is described by the top-level link:https://cgit.freebsd.org/src/tree/README.md[README.md] file.