From 89dff32a034080cf49cf9f48097aa87cd8474727 Mon Sep 17 00:00:00 2001
From: Carl George <carlwgeorge@gmail.com>
Date: Dec 11 2024 10:24:30 +0000
Subject: Add CS10 release notes


As discussed as few times at the promo meetings and in chat, we should
have proper release notes.  This creates that page and adds a link to it
(and the existing CS9 release notes) on the downloads page.  It also
adds a link to it from the header documentation dropdown.

---

diff --git a/_data/centos/cards.yml b/_data/centos/cards.yml
index 3bcef2d..4614733 100644
--- a/_data/centos/cards.yml
+++ b/_data/centos/cards.yml
@@ -46,11 +46,7 @@
           vagrant: ""
       documentation:
         - title: Release Notes
-          link: "https://blog.centos.org/2021/12/introducing-centos-stream-10/"
-        - title: Release Email
-          link: "https://lists.centos.org/pipermail/centos-announce/2021-December/060971.html"
-        - title: Website
-          link: "https://docs.centos.org/en-US/docs/"
+          link: "/centos10/"
       eol:
         - url: ""
           overview: |
@@ -89,12 +85,10 @@
           containers: "https://quay.io/centos/centos:stream9"
           vagrant: ""
       documentation:
-        - title: Release Notes
+        - title: Release Announcement
           link: "https://blog.centos.org/2021/12/introducing-centos-stream-9/"
-        - title: Release Email
-          link: "https://lists.centos.org/pipermail/centos-announce/2021-December/060971.html"
-        - title: Website
-          link: "https://docs.centos.org/en-US/docs/"
+        - title: Release Notes
+          link: "/stream9/"
       eol:
         - url: ""
           overview: |
diff --git a/_data/centos/navbar.yml b/_data/centos/navbar.yml
index 488b107..b524814 100644
--- a/_data/centos/navbar.yml
+++ b/_data/centos/navbar.yml
@@ -56,4 +56,6 @@
       link: "https://docs.centos.org/"
     - name: "GPG Key Info"
       link: "/keys"
+    - name: "Release Notes"
+      link: "/centos10/"
   visible_on: ["navbar"]
diff --git a/centos10.md b/centos10.md
new file mode 100644
index 0000000..0b24d73
--- /dev/null
+++ b/centos10.md
@@ -0,0 +1,123 @@
+---
+title: CentOS Stream 10 Release Notes
+---
+
+## Introduction
+
+Welcome to CentOS Stream 10 "Coughlan",
+the latest version of the CentOS Project distribution.
+
+CentOS Stream defines Enterprise Linux.
+It is a Linux distribution built by Red Hat Enterprise Linux (RHEL) engineers,
+and is used as the major version branch that RHEL minor versions are created from.
+It has roughly a five year lifecycle and will be maintained until 2030.
+The exact date will be contingent on the end of the Full Support phase of RHEL 10.
+
+## Architectures
+
+CentOS Stream 10 uses the Linux 6.12 kernel,
+which provides support for the following architectures.
+
+* x86\_64 (v3)
+* aarch64
+* ppc64le (power9)
+* s390x (z14)
+
+## Repositories
+
+CentOS Stream 10 is distributed through two main DNF repositories,
+BaseOS and AppStream.
+The CRB repository is also available, but is disabled by default.
+
+### BaseOS
+
+Packages in the BaseOS repository are intended to provide the core set of operating system functionality.
+
+### AppStream
+
+Packages in the AppStream repository include additional user-space applications, runtime languages, and databases
+to accomodate various workloads and use cases.
+
+### CRB
+
+Packages in the CRB repository are intended to accomodate development use cases.
+
+## New features and enhancements
+
+CentOS Stream 10 includes several notable new features and enhancements.
+
+### Programming languages and compilers
+
+* Python 3.12
+* GCC 14
+* Go 1.23
+* Rust 1.82
+* LLVM 19
+* Ruby 3.3
+* Node.js 22
+* PHP 8.3
+* OpenJDK 21
+
+### Webservers
+
+* Apache HTTP Server 2.4.62
+* nginx 1.26
+
+### Databases
+
+* PostgreSQL 16
+* MariaDB 10.11
+* MySQL 8.4
+* Valkey 7.2
+
+### Desktop technologies
+
+* GNOME 47
+* Qt 6.7
+
+## Removed functionality
+
+CentOS Stream 10 does not include some packages that were previously included in CentOS Stream 9.
+
+### Xorg server
+
+Xorg server (`xorg-x11-server-Xorg`) is no longer included.
+Wayland is the default display stack,
+with Xwayland (`xorg-x11-server-Xwayland`) available as a compatibility layer for legacy X11 applications.
+You can read more about this transition in the blog post
+[Red Hat Enterprise Linux 10 plans for Wayland and Xorg server](https://www.redhat.com/en/blog/rhel-10-plans-wayland-and-xorg-server).
+
+### Desktop applications
+
+Most graphical desktop applications have been removed.
+This includes:
+
+* Firefox
+* GIMP
+* LibreOffice
+* Inkscape
+* Thunderbird
+
+RHEL is transitioning to providing desktop applications via Flatpak.
+CentOS users who want these applications are encouraged to install them from
+[Flathub](https://flathub.org) or
+[request them in EPEL](https://docs.fedoraproject.org/en-US/epel/epel-package-request/).
+
+### Redis
+
+Redis has been replaced with Valkey, a Redis fork.
+
+## Known issues
+
+### Secureboot
+
+At this time, CentOS Stream 10 does not work with secureboot enabled.
+This is currently blocked on [a shim review](https://github.com/rhboot/shim-review/issues/454).
+
+## More information
+
+This page is intended as an overview of the basic properties of CentOS Stream 10,
+but it is not an exhaustive list of all changes and topics.
+The [RHEL 10 Beta documentation](https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/10-beta/)
+provides additional notes and guides which mostly apply to CentOS Stream as well.
+