From nobody Wed Nov 09 07:16:53 2022 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4N6br611ldz4V63Z for ; Wed, 9 Nov 2022 07:16:54 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4N6br60YLxz3Hqb; Wed, 9 Nov 2022 07:16:54 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1667978214; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=ng6uYerUd++X8qsPyRAiyEyoAey18vcLCNxaw2NGoHs=; b=VSTRhBoaWV16FWdUX3+Eh0/LWvuHEVSgojrv5IgK5ohZGATOJWm/xzYHwUlA5XDliClcw9 ZAqZTI7HHAVw34Lvq7aRLTyetjCZ6x57YyTNg2wvgCawJZotabjvWnUQsZ3IuykRjDHpCp c2SiVRh1jq1ogMBUk3/F5dO164bhLhseu4kjgpKVeqNQMF1fLdQ684hTkRSvECIc58PUUE CvJ5ZPK3SvL3zx2olTvTw8EEGtdIfEpTxjW84ZQnqHMpO+hiqcBRxCldpuU4NbYsNv9GW/ Ep/hY0J1izD2A5BUy80pjKSprPk6oD9geVXu+NYTVnHAHI5hHOhciCAdUpfyYg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1667978214; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=ng6uYerUd++X8qsPyRAiyEyoAey18vcLCNxaw2NGoHs=; b=Ar98lCmOrNF52VX//xy6sj91DWWfTRplVqXXatLGCau40l3fFoAtOygLe1o4pWk/XTMzcY Vfcr852ylaj5eMIhTwCN6y9Mm7v+F2jGLcv8C5DqGntJJSx+1021IOm8lrESaCZKEcYrRt BGvet504sccMhPuHfx+9YRk28F/sF+Hg1dndDs50qdyAFDCYqPVMkVOvmzV5rlPgs1iiA0 RZA16HAwW+quCbtCvq4dLc0gBPosHSESZ31/xvnoj1AWaxfcRO/oqRPSkxx2UPm3lonAH7 ucQduIOMcwvwn6647HGJDygqwZAb+tRqj63OKnujeQugrFco6mE0Hug93+jBFA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1667978214; a=rsa-sha256; cv=none; b=vvMAc3WheD5DKM/vSYwTByGcm1sAWsauMb8FHfTBnVuQbJIf7r3N/UwM9nOi+yPFiL6Kl4 MvX/Yo5Y2oUEZ9uAZGqWyDnTddozW4r5xAAtsPp+WLQ+QWUmYwvYRYKtchuPPNa/y5rCHG ywIXrtaeXCEkeYFk2dMY/gPx/VGGZeozWvBHSWHTAmR8QE1dESWZQc2N19ne2CFqIEGsgn lUtKD6qRIsVQ0oNBJStFZEG2CGwsHJ0S057uOj23NZNbhB/PYhGlSkQiCRWtGCGjhBw3yd G1q/hT3raBlZ6F7mVQ04jE+LhlI7p8NXOrT6Py+3QAYDefk0WFoN9Qju1bCPEA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4N6br56GBSz1CZf; Wed, 9 Nov 2022 07:16:53 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 2A97GrA2035975; Wed, 9 Nov 2022 07:16:53 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 2A97GrIL035974; Wed, 9 Nov 2022 07:16:53 GMT (envelope-from git) Date: Wed, 9 Nov 2022 07:16:53 GMT Message-Id: <202211090716.2A97GrIL035974@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Graham Perrin Subject: git: faba218b92 - main - Get FreeBSD: section levels, and article title List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: grahamperrin X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: faba218b92835dddb153584265b83c40bcdfdf96 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by grahamperrin: URL: https://cgit.FreeBSD.org/doc/commit/?id=faba218b92835dddb153584265b83c40bcdfdf96 commit faba218b92835dddb153584265b83c40bcdfdf96 Author: Graham Perrin AuthorDate: 2022-11-09 06:59:22 +0000 Commit: Graham Perrin CommitDate: 2022-11-09 06:59:22 +0000 Get FreeBSD: section levels, and article title AsciiDoc for an article type document (the default): fix the level of each section below the sole section that is level zero (the title). https://docs.asciidoctor.org/asciidoc/latest/syntax-quick-reference/#section-titles The FreeBSD Project home page describes https://www.freebsd.org/where/ as 'Get FreeBSD', not 'Download FreeBSD'. Gain consistency in this page. (Consistency in the FreeBSD Handbook and elsewhere may be gained through future reviews.) Approved by: gjb Fixes: 5c8cc20333c4 Download FreeBSD: headings, redundancy, clarity Differential revision: https://reviews.freebsd.org/D37307 --- website/content/en/where.adoc | 38 ++++++++++++++++++++------------------ 1 file changed, 20 insertions(+), 18 deletions(-) diff --git a/website/content/en/where.adoc b/website/content/en/where.adoc index 46e06bf5f5..5bfc2871b2 100644 --- a/website/content/en/where.adoc +++ b/website/content/en/where.adoc @@ -1,5 +1,5 @@ --- -title: "Download FreeBSD" +title: "Get FreeBSD" sidenav: download --- @@ -9,11 +9,13 @@ sidenav: download include::shared/releases.adoc[] include::shared/en/urls.adoc[] += Get FreeBSD + For general information about past, present and future releases, see link:../releases/[Release Information]. [[choose-version]] [[choose-arch]] -= Choosing an Architecture +== Choosing an Architecture Most users of FreeBSD will have hardware for **amd64** or **aarch64**. These architectures are well-supported. @@ -24,7 +26,7 @@ Embedded devices and single-board computers (SBCs) such as the Raspberry Pi 3 an For all other architectures, please see the link:../platforms/#_supported_platforms[table of supported platforms]. [[choose-image]] -= Choosing an Image +== Choosing an Image For the FreeBSD installer: formats include CD (disc1), DVD (dvd1), and network install (bootonly) sized ISO, plus regular and mini USB memory sticks. @@ -33,12 +35,12 @@ For virtual machines: virtual disk images have FreeBSD preinstalled. For embedded platforms: SD card images are available. [[download]] -= Production Quality +== Production Quality `RELEASE` versions of FreeBSD are the end result of _release engineering_. [[download-rel131]] -== FreeBSD {rel131-current}-RELEASE +=== FreeBSD {rel131-current}-RELEASE [.tblbasic] [.tblDownload] [width="100%",cols="25%,25%,25%,25%",options="header",] @@ -92,7 +94,7 @@ a| |=== [[download-rel123]] -== FreeBSD {rel123-current}-RELEASE +=== FreeBSD {rel123-current}-RELEASE [.tblbasic] [.tblDownload] @@ -141,7 +143,7 @@ a| |=== [[helptest]] -= Development and Testing +== Development and Testing Pre-`RELEASE` versions of FreeBSD, not intended for use in production environments: @@ -160,7 +162,7 @@ The word `CURRENT` is sometimes a source of confusion: – `CURRENT` has special meaning in the development process. [[download-rel124]] -== FreeBSD {rel124-current}-RC1 +=== FreeBSD {rel124-current}-RC1 [.tblbasic] [.tblDownload] @@ -209,24 +211,24 @@ a| |=== [[download-snapshots]] -== Development Snapshots +=== Development Snapshots See link:../snapshots/[FreeBSD Snapshot Releases]. -== FreeBSD {rel-head}-CURRENT +=== FreeBSD {rel-head}-CURRENT Installer and SD card images are available for link:{url-snapshot}/amd64/amd64/ISO-IMAGES/{rel-head}/[amd64], link:{url-snapshot}/i386/i386/ISO-IMAGES/{rel-head}/[i386], link:{url-snapshot}/powerpc/powerpc/ISO-IMAGES/{rel-head}/[powerpc], link:{url-snapshot}/powerpc/powerpc64/ISO-IMAGES/{rel-head}/[powerpc64], link:{url-snapshot}/powerpc/powerpc64le/ISO-IMAGES/{rel-head}/[powerpc64le], link:{url-snapshot}/powerpc/powerpcspe/ISO-IMAGES/{rel-head}/[powerpcspe], link:{url-snapshot}/arm/armv6/ISO-IMAGES/{rel-head}/[armv6], link:{url-snapshot}/arm/armv7/ISO-IMAGES/{rel-head}/[armv7], link:{url-snapshot}/arm64/aarch64/ISO-IMAGES/{rel-head}/[aarch64], and link:{url-snapshot}/riscv/riscv64/ISO-IMAGES/{rel-head}/[riscv64]. VM images are available for link:{url-snapshot}/VM-IMAGES/{rel-head}-CURRENT/amd64/Latest/[amd64], link:{url-snapshot}/VM-IMAGES/{rel-head}-CURRENT/i386/Latest/[i386], link:{url-snapshot}/VM-IMAGES/{rel-head}-CURRENT/aarch64/Latest/[aarch64], and link:{url-snapshot}/VM-IMAGES/{rel-head}-CURRENT/riscv64/Latest/[riscv64]. -== FreeBSD {rel131-current}-STABLE +=== FreeBSD {rel131-current}-STABLE Installer and SD card images are available for link:{url-snapshot}/amd64/amd64/ISO-IMAGES/{rel131-current}/[amd64], link:{url-snapshot}/i386/i386/ISO-IMAGES/{rel131-current}/[i386], link:{url-snapshot}/powerpc/powerpc/ISO-IMAGES/{rel131-current}/[powerpc], link:{url-snapshot}/powerpc/powerpc64/ISO-IMAGES/{rel131-current}/[powerpc64], link:{url-snapshot}/powerpc/powerpc64le/ISO-IMAGES/{rel131-current}/[powerpc64le], link:{url-snapshot}/powerpc/powerpcspe/ISO-IMAGES/{rel131-current}/[powerpcspe], link:{url-snapshot}/arm/armv6/ISO-IMAGES/{rel131-current}/[armv6], link:{url-snapshot}/arm/armv7/ISO-IMAGES/{rel131-current}/[armv7], link:{url-snapshot}/arm64/aarch64/ISO-IMAGES/{rel131-current}/[aarch64], and link:{url-snapshot}/riscv/riscv64/ISO-IMAGES/{rel131-current}/[riscv64]. VM images are available for link:{url-snapshot}/VM-IMAGES/{rel131-current}-STABLE/amd64/Latest/[amd64], link:{url-snapshot}/VM-IMAGES/{rel131-current}-STABLE/i386/Latest/[i386], link:{url-snapshot}/VM-IMAGES/{rel131-current}-STABLE/aarch64/Latest/[aarch64], and link:{url-snapshot}/VM-IMAGES/{rel131-current}-STABLE/riscv64/Latest/[riscv64]. //// -== FreeBSD {rel123-current}-STABLE +=== FreeBSD {rel123-current}-STABLE Installer and SD card images are available for link:{url-snapshot}/amd64/amd64/ISO-IMAGES/{rel123-current}/[amd64], link:{url-snapshot}/i386/i386/ISO-IMAGES/{rel123-current}/[i386], link:{url-snapshot}/powerpc/powerpc/ISO-IMAGES/{rel123-current}/[powerpc], link:{url-snapshot}/powerpc/powerpc64/ISO-IMAGES/{rel123-current}/[powerpc64], link:{url-snapshot}/powerpc/powerpcspe/ISO-IMAGES/{rel123-current}/[powerpcspe], link:{url-snapshot}/sparc64/sparc64/ISO-IMAGES/{rel123-current}/[sparc64], link:{url-snapshot}/arm/armv6/ISO-IMAGES/{rel123-current}/[armv6], link:{url-snapshot}/arm/armv7/ISO-IMAGES/{rel123-current}/[armv7], and link:{url-snapshot}/arm64/aarch64/ISO-IMAGES/{rel123-current}/[aarch64]. @@ -234,7 +236,7 @@ VM images are available for link:{url-snapshot}/VM-IMAGES/{rel123-current}-STABL //// [[install]] -= Installation +== Installation Options include: @@ -246,14 +248,14 @@ Before downloading an entire distribution, please read the link:{handbook}bsdins If you plan to get FreeBSD via FTP or HTTPS, check the FreeBSD Handbook for link:{handbook}mirrors/#mirrors[suitable mirrors] for your region. [[distribution]] -= Purchase FreeBSD Media +== Purchase FreeBSD Media FreeBSD can be acquired on CD-ROM or DVD from https://www.freebsdmall.com/[FreeBSD Mall], and other link:{handbook}mirrors/#mirrors-cdrom[CD-ROM and DVD publishers]. [[apps]] -= Applications and Utility Software +== Applications and Utility Software -== The Ports Collection +=== The Ports Collection A diverse collection of utility and application software that has been _ported_ to FreeBSD. @@ -265,7 +267,7 @@ A diverse collection of utility and application software that has been _ported_ For information about how _you_ can contribute _your_ favorite piece of software to the Collection, have a look at _link:{porters-handbook}[The Porter's Handbook]_ and _link:{contributing}[Contributing to FreeBSD]_. [[derived]] -= FreeBSD-derived Operating System Distributions +== FreeBSD-derived Operating System Distributions FreeBSD is widely used as a building block for other commercial and open-source operating systems. The projects below are of particular interest. @@ -277,6 +279,6 @@ The projects below are of particular interest. * https://www.pfsense.org/[pfSense] is a FreeBSD-based customized distribution tailored for use as a firewall and router. [[past]] -= Archives +== Archives http://ftp-archive.FreeBSD.org/pub/FreeBSD-Archive/old-releases/[Past releases] of FreeBSD.