git: b04b9b6490 - main - 13.3 relnotes: create skeleton

From: Mike Karels <karels_at_FreeBSD.org>
Date: Thu, 15 Feb 2024 16:13:59 UTC
The branch main has been updated by karels:

URL: https://cgit.FreeBSD.org/doc/commit/?id=b04b9b6490c78846fbf67f91bb01d659062cc44d

commit b04b9b6490c78846fbf67f91bb01d659062cc44d
Author:     Mike Karels <karels@FreeBSD.org>
AuthorDate: 2024-02-15 16:12:31 +0000
Commit:     Mike Karels <karels@FreeBSD.org>
CommitDate: 2024-02-15 16:13:50 +0000

    13.3 relnotes: create skeleton
    
    Create the skeleton for the 13.3 release notes, starting with the 13.2
    version.
    
    Differential Revision:  https://reviews.freebsd.org/D43840
---
 website/content/en/releases/13.3R/relnotes.adoc | 168 ++++++++++++++++++++++++
 1 file changed, 168 insertions(+)

diff --git a/website/content/en/releases/13.3R/relnotes.adoc b/website/content/en/releases/13.3R/relnotes.adoc
new file mode 100644
index 0000000000..b2cacf3096
--- /dev/null
+++ b/website/content/en/releases/13.3R/relnotes.adoc
@@ -0,0 +1,168 @@
+---
+title: "FreeBSD 13.3-RELEASE Release Notes"
+sidenav: download
+---
+
+:releaseCurrent: 13.3-RELEASE
+:releaseBranch: 13-STABLE
+:releasePrev: 13.2-RELEASE
+:releaseNext: 13.4-RELEASE
+:releaseType: release
+
+include::shared/en/urls.adoc[]
+
+= FreeBSD {releaseCurrent} Release Notes
+:doctype: article
+:toc: macro
+:toclevels: 1
+:icons: font
+
+== Abstract
+
+[.abstract-title]
+The release notes for FreeBSD {releaseCurrent} contain a summary of the changes made to the FreeBSD base system on the {releaseBranch} development line.
+This document lists applicable security advisories that were issued since the last release, as well as significant changes to the FreeBSD kernel and userland.
+Some brief remarks on upgrading are also presented.
+
+[[intro]]
+== Introduction
+
+This document contains the release notes for FreeBSD {releaseCurrent}.
+It describes recently added, changed, or deleted features of FreeBSD.
+It also provides some notes on upgrading from previous versions of FreeBSD.
+
+The {releaseType} distribution to which these release notes apply represents the latest point along the {releaseBranch} development branch since {releaseBranch} was created.
+Information regarding pre-built, binary {releaseType} distributions along this branch can be found at https://www.FreeBSD.org/releases/[].
+
+The {releaseType} distribution to which these release notes apply represents a point along the {releaseBranch} development branch between {releasePrev} and the future {releaseNext}.
+Information regarding pre-built, binary {releaseType} distributions along this branch can be found at https://www.FreeBSD.org/releases/[].
+
+This distribution of FreeBSD {releaseCurrent} is a {releaseType} distribution.
+It can be found at https://www.FreeBSD.org/releases/[] or any of its mirrors.
+More information on obtaining this (or other) {releaseType} distributions of FreeBSD can be found in the link:{handbook}/mirrors[Obtaining FreeBSD appendix] to the link:{handbook}/[FreeBSD Handbook].
+
+All users are encouraged to consult the release errata before installing FreeBSD.
+The errata document is updated with "late-breaking" information discovered late in the release cycle or after the release.
+Typically, it contains information on known bugs, security advisories, and corrections to documentation.
+An up-to-date copy of the errata for FreeBSD {releaseCurrent} can be found on the FreeBSD Web site.
+
+This document describes the most user-visible new or changed features in FreeBSD {releaseBranch} since {releasePrev}.
+Note that some of the changes described here are also available in FreeBSD 14.0-RELEASE.
+
+Typical release note items document recent security advisories issued after {releasePrev}, new drivers or hardware support, new commands or options, major bug fixes, or contributed software upgrades.
+They may also list changes to major ports/packages or release engineering practices.
+Clearly the release notes cannot list every single change made to FreeBSD between releases; this document focuses primarily on security advisories, user-visible changes, and major architectural improvements.
+
+[[upgrade]]
+== Upgrading from Previous Releases of FreeBSD
+
+Binary upgrades between RELEASE versions (and snapshots of the various security branches) are supported using the man:freebsd-update[8] utility.
+The link:{handbook}cutting-edge/#freebsdupdate-upgrade[binary upgrade procedure] will update unmodified userland utilities, as well as unmodified GENERIC kernels distributed as a part of an official FreeBSD release.
+The man:freebsd-update[8] utility requires that the host being upgraded have Internet connectivity.
+
+Source-based upgrades (those based on recompiling the FreeBSD base system from source code) from previous versions are supported, according to the instructions in [.filename]#/usr/src/UPDATING#.
+
+[IMPORTANT]
+====
+Upgrading FreeBSD should only be attempted after backing up **all** data and configuration files.
+====
+
+[IMPORTANT]
+====
+After installing the new userland software, running daemons are still from the previous version.
+After installing the user-level components with the second invocation of freebsd-update, or via an upgrade from source with `installworld`, the system should be rebooted to start everything with the new software.
+For example, older versions of `sshd` failed to process incoming connections correctly after the new [.filename]#/usr/sbin/sshd# was installed; rebooting started a new `sshd` and other daemons.
+====
+
+////
+XXX: Release Engineering Lead will fill this in just before the release is final
+[[security-errata]]
+== Security and Errata
+
+This section lists the various Security Advisories and Errata Notices since {releasePrev}.
+
+[[security]]
+=== Security Advisories
+
+[width="100%",cols="40%,30%,30%",options="header",]
+|===
+|Advisory |Date |Topic
+|link:https://www.freebsd.org/security/advisories/FreeBSD-SA-20:31.icmp6.asc[FreeBSD-SA-20:31.icmp6] |1 December 2020 |Use-after-free in error message handling
+|===
+
+[[errata]]
+=== Errata Notices
+
+[width="100%",cols="40%,30%,30%",options="header",]
+|===
+|Errata |Date |Topic
+|===
+////
+
+[[userland]]
+== Userland
+
+This section covers changes and additions to userland applications, contributed software, and system utilities.
+
+[[userland-config]]
+=== Userland Configuration Changes
+
+// SAMPLE ENTRY:
+// A new man:rc.conf[5] variable has been added, `linux_mounts_enable`, which controls if Linux(R)-specific filesystems are mounted in [.filename]#/compat/linux# if `linux_enable` is set to `YES`.
+// gitref:1234567890ab[repository=src] (Sponsored by The FreeBSD Foundation)
+
+[[userland-programs]]
+=== Userland Application Changes
+
+[[userland-contrib]]
+=== Contributed Software
+
+[[userland-libraries]]
+=== Runtime Libraries and API
+
+[[kernel]]
+== Kernel
+
+This section covers changes to kernel configurations, system tuning, and system control parameters that are not otherwise categorized.
+
+[[kernel-general]]
+=== General Kernel Changes
+
+[[drivers]]
+== Devices and Drivers
+
+This section covers changes and additions to devices and device drivers since {releasePrev}.
+
+[[drivers-device]]
+=== Device Drivers
+
+[[storage]]
+== Storage
+
+This section covers changes and additions to file systems and other storage subsystems, both local and networked.
+
+[[storage-nfs]]
+=== NFS Changes
+
+[[storage-ufs]]
+=== UFS Changes
+
+[[boot]]
+== Boot Loader Changes
+
+This section covers the boot loader, boot menu, and other boot-related changes.
+
+[[boot-loader]]
+=== Boot Loader Changes
+
+[[network]]
+== Networking
+
+This section describes changes that affect networking in FreeBSD.
+
+[[network-general]]
+=== General Network
+
+[[future-releases]]
+== General Notes Regarding Future FreeBSD Releases
+