Document the status of various top-level Warewulf features

Signed-off-by: Jonathon Anderson <janderson@ciq.com>

CHANGELOG.md

@@ -63,6 +63,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
   `/initramfs/`, `/system/`, `/runtime/`, `/grub/`, `/efiboot/`).
 - Documented how to detect shadowed overlays in troubleshooting.
 - Documented `wwctl clean`. #2034
+- Documented the status of various top-level Warewulf features.
 
 
 ### Changed

userdocs/getting-started/feature-status.rst

@@ -0,0 +1,72 @@
+==============
+Feature Status
+==============
+
+The following table summarizes the maturity of Warewulf's top-level features.
+Features are classified as follows:
+
+* **Stable** -- Production-ready; the interface is well-tested and unlikely to
+  change in incompatible ways.
+* **Preview** -- Functional, but may have rough edges, limited testing, or an
+  interface that is still evolving.
+* **Incomplete** -- Work-in-progress; key functionality or the user-facing
+  interface is not yet complete.
+
+.. list-table::
+   :widths: 30 15 55
+   :header-rows: 1
+
+   * - Feature
+     - Status
+     - Notes
+   * - iPXE
+     - Stable
+     - Default network bootloader used for PXE booting cluster nodes.
+   * - GRUB
+     - Preview
+     - Alternative bootloader; useful for UEFI and Secure Boot scenarios.
+   * - Single-stage boot
+     - Stable
+     - Default provisioning mode; the OS image is used directly as the root
+       filesystem.
+   * - Two-stage boot
+     - Preview
+     - Uses an intermediate initrd to initialize hardware before loading the
+       final OS image. Requires Dracut-based images.
+   * - Nodes
+     - Stable
+     - Core node management (add, remove, configure, list).
+   * - Profiles
+     - Stable
+     - Abstract node profiles for sharing configuration across groups of nodes.
+   * - Overlays
+     - Stable
+     - Template-based file provisioning applied to OS images at boot and at
+       runtime.
+   * - OS images
+     - Stable
+     - Container-based OS image import, management, and provisioning.
+   * - Read-only images
+     - Preview
+     - Marking an image read-only to enable future support for image
+       subscriptions and updates.
+   * - Kernels
+     - Stable
+     - Kernel extraction from OS images and per-node kernel management.
+   * - Disk provisioning
+     - Preview
+     - Partitioning and formatting disks on cluster nodes during provisioning.
+   * - Provision-to-disk
+     - Preview
+     - Provisioning an OS image to disk so that the node can subsequently boot
+       without Warewulf.
+   * - Resources
+     - Incomplete
+     - Generic node resources; the user-facing interface is not yet complete.
+   * - Secure Boot
+     - Preview
+     - UEFI Secure Boot support via signed bootloaders.
+   * - dnsmasq
+     - Preview
+     - Using dnsmasq as an alternative to ISC dhcpd and TFTP for DHCP and
+       network boot services.

userdocs/index.rst

@@ -16,6 +16,7 @@ Welcome to the Warewulf User Guide!
    Debian Quickstart <getting-started/debian-quickstart>
    Glossary <getting-started/glossary>
    Quick Reference <getting-started/quick-reference>
+   Feature Status <getting-started/feature-status>
 
 .. toctree::
    :maxdepth: 1