Merge pull request #113 from neatudarius/issue/112

December 2025 docs sync

Author: neatudarius

docs/beman_library_maturity_model.md

@@ -20,13 +20,13 @@ These libraries may deviate from the Beman Standard due to incompleteness, lack
 
 ### Production ready. API may undergo changes.
 
-These Beman-compliant libraries are production-ready, fully implementing the target paper with complete testing and documentation. Users should be aware that future API changes are possible and that standardization is not guaranteed.
+These Beman-compliant libraries are production-ready, fully implementing the target paper with complete testing and documentation. Users should be aware that future API changes are possible and that standardization is not guaranteed. See below for details on the requirements to transition to production-ready.
 
 > These libraries are recommended for production usage.
 
 ### Production ready. Stable API.
 
-These production-ready libraries offer stable, standardized APIs. They are part of the C++ Standard and can be used as a polyfill for compilers lacking native support. Note that these libraries will be retired after two standardization cycles (6 years).
+These production-ready libraries offer stable, standardized APIs.  They are part of the C++ Standard and can be used as a polyfill for compilers lacking native support. Note that these libraries will be retired after two standardization cycles (6 years).
 
 > These libraries are recommended for production usage.
 
@@ -37,10 +37,58 @@ These libraries were archived and no longer maintained. These libraries are not
 > These libraries are not recommended for production use!
 > These libraries were removed from the Beman main distribution, but the initial authors could still support them outside the Beman Project.
 
+
 Transition examples:
 
-- They were [Production ready. Stable API.](./beman_library_maturity_model.md#production-ready-stable-api) at some point, but are no longer developed or maintained, being superseded by native compiler implementations - `Mature retirement`.
+* They were [Production ready. Stable API.](./beman_library_maturity_model.md#production-ready-stable-api) at some point, but are no longer developed or maintained, being superseded by native compiler implementations - `Mature retirement`.
+
+* They were [Production ready. API may undergo changes.](./beman_library_maturity_model.md#production-ready-api-may-undergo-changes) at some point, but are no longer developed or maintained, being rejected from the ISO C++ Standardization - `Early retirement`.
+
+* They were [Under development and not yet ready for production use.](./beman_library_maturity_model.md#under-development-and-not-yet-ready-for-production-use) at some point and were abandoned - `Early retirement`.
+
+
+## Review Process for Transitioning a Library to “Production Ready”
+
+For a Beman Project library from **Under Development** to **Production Ready** status a formal review needs to be completed.
+The intent is to ensure that every production-ready library meets the Beman standard for quality, completeness, and 
+documentation, and that it has received sufficient community review and testing.
+
+---
+
+### Review Process Details
+
+
+1. **Review Logistics**
+   Typically this is requested by the library author, but any community member that feels a library is ready can suggest
+   a review.  The review will be managed by one or more leads or an lead appointee/volunteer.
+
+   A post is made on [Discourse](https://discourse.bemanproject.org) announcing the start of a **two-week library review** period.
+   The announcement should include:
+
+   * The released version of the library to review.
+   * Link to a PR to review for review comments.
+     - Note: The PR may not have much diff content but is the place for gathering feedback.
+   * Any other guidance for the reviewers.
+   
+3. **Review Criteria**
+   To be eligible for *Production Ready* status, a library must demonstrate that it:
+
+   * Meets the **Beman Standard** with deviations documented (passes beman.tidy checks).
+   * Has **comprehensive unit test coverage** validating functionality and edge cases.
+   * Includes **complete and accurate documentation**, including tutorial, design rationale, and examples.
+
+   Note that much of the design documentation may simply reference the WG21 paper. 
+   Also note that since the current documentation system is a work in progress, docs should be Markdown for now.
+
+4. **Community Evaluation**
+   During the review period, the community is encouraged to:
+
+   * Build and test the library on supported platforms.
+   * Review its design and documentation.
+   * Provide feedback and raise issues for discussion.
 
-- They were [Production ready. API may undergo changes.](./beman_library_maturity_model.md#production-ready-api-may-undergo-changes) at some point, but are no longer developed or maintained, being rejected from the ISO C+ Standardization - `Early retirement`.
+4. **Approval Requirements**
+   A library may transition to *Production Ready* status only after:
 
-- They were [Under development and not yet ready for production use.](./beman_library_maturity_model.md#under-development-and-not-yet-ready-for-production-use) at some point and were abandoned - `Early retirement`.
+   * Demonstrated **positive community consensus** that the review criteria have been met as determined by **at least two project leads**, or
+   * in the rare case there is lack of consensus, the leads make a call. 

docs/beman_standard.md

@@ -328,6 +328,8 @@ If the library has been deployed onto Compiler Explorer, add this badge and repl
 [Give **std::optional** Range Support (P3168R1)](https://wg21.link/P3168R1).
 ```
 
+Note that specifying the revision number is optional.
+
 ### **[readme.library_status]**
 
 **Requirement**: Following the implements section and a newline, the `README.md` must indicate the **current** library status with respect to the [Beman library maturity model](https://github.com/bemanproject/beman/blob/main/docs/beman_library_maturity_model.md). An extra badge must be added to the `README.md` to visually indicate the library status (check `[readme.badges]`). Note: The full library status history can be found in the GitHub release notes.

docs/governance.md

@@ -12,7 +12,7 @@ The Beman Project is dedicated to providing the guidance and facilities to ensur
 We help library authors with development best practices, peer review, and contributing to the C++ standard.
 We distribute the libraries proposed for standardization to facilitate early usage and feedback.
 
-The Beman project is named in memory of Beman Dawes - co-founder of [Boost](https://www.boost.org).
+The Beman Project is named in memory of Beman Dawes - co-founder of [Boost](https://www.boost.org).
 
 # 2. Membership
 
@@ -65,8 +65,8 @@ Removal as a Beman Project Library Author may be done when the library no longer
 
 # 4.1 Consensus Decision-Making:
 
-Beman Project strives to make decisions through consensus among the Project Contributors and the Project Leads.  
-Proposals on the best way to proceed should be discussed in good faith.  
+Beman Project strives to make decisions through consensus among the Project Contributors and the Project Leads.
+Proposals on the best way to proceed should be discussed in good faith.
 Beman Project Leads ultimately decide the direction of the Project.
 
 # 5. Code of Conduct