Blame
|
1 | # Release System |
||||||
| 2 | ||||||||
| 3 | AeThex separates public releases, product changelogs, documentation changes, deployments, incidents, and community announcements. These records may reference one another, but they are not interchangeable. |
|||||||
| 4 | ||||||||
| 5 | | Field | Value | |
|||||||
| 6 | |---|---| |
|||||||
| 7 | | Documentation status | Active | |
|||||||
| 8 | | Applies to | Corporation, Foundation, and Labs | |
|||||||
| 9 | | Public release directory | [aethex.us/releases](https://aethex.us/releases) | |
|||||||
| 10 | | Canonical documentation | [docs.aethex.support](https://docs.aethex.support) | |
|||||||
| 11 | | Last verified | 2026-07-29 | |
|||||||
| 12 | ||||||||
| 13 | ## Public hierarchy |
|||||||
| 14 | ||||||||
| 15 | 1. **Ecosystem releases** — `aethex.us/releases` presents curated public changes across all three Trinity arms. |
|||||||
| 16 | 2. **Trinity views** — Corporation, Foundation, and Labs filters use the same release records. |
|||||||
| 17 | 3. **Product changelogs** — product domains show only releases that affect that product. |
|||||||
| 18 | 4. **Release details** — permanent pages describe changes, availability, affected domains, documentation, and known limitations. |
|||||||
| 19 | 5. **Technical documentation** — `docs.aethex.support` explains how released behavior works. |
|||||||
| 20 | 6. **Engineering history** — repositories and staff deployment records retain commits, builds, and rollback details. |
|||||||
| 21 | ||||||||
| 22 | ## Record types |
|||||||
| 23 | ||||||||
| 24 | | Record | Purpose | Public location | |
|||||||
| 25 | |---|---|---| |
|||||||
| 26 | | Release | Curated user-visible product change | `aethex.us/releases` | |
|||||||
| 27 | | Product changelog entry | Product-filtered release | Product `/changelog` | |
|||||||
| 28 | | Release note | Detailed behavior, compatibility, and migration information | `docs.aethex.support` | |
|||||||
| 29 | | Documentation change | Change to manuals or reference material | Documentation changelog | |
|||||||
| 30 | | Deployment | Environment, build, commit, and rollback evidence | Engineering/staff history | |
|||||||
| 31 | | Incident | Availability degradation and resolution | Status service | |
|||||||
| 32 | | Security advisory | Coordinated vulnerability disclosure | Security advisory section | |
|||||||
| 33 | | Announcement | News that may not change a product | Product or community feed | |
|||||||
| 34 | ||||||||
| 35 | ## Required release fields |
|||||||
| 36 | ||||||||
| 37 | - Stable release identifier |
|||||||
| 38 | - Title and plain-language summary |
|||||||
| 39 | - Primary Trinity owner |
|||||||
| 40 | - Collaborating Trinity arms, when applicable |
|||||||
| 41 | - Product and affected components |
|||||||
| 42 | - Primary and affected domains |
|||||||
| 43 | - Release channel and maturity |
|||||||
| 44 | - Version or dated web-release identifier |
|||||||
| 45 | - Publication and production-availability timestamps |
|||||||
| 46 | - Added, changed, fixed, security, deprecated, and removed items as applicable |
|||||||
| 47 | - Documentation and migration links |
|||||||
| 48 | - Known limitations |
|||||||
| 49 | - Deployment evidence |
|||||||
| 50 | - Author and approver |
|||||||
| 51 | - Correction, supersession, rollback, or withdrawal state |
|||||||
| 52 | ||||||||
| 53 | ## Publication flow |
|||||||
| 54 | ||||||||
| 55 | ```text |
|||||||
| 56 | Code or configuration change |
|||||||
| 57 | → engineering/deployment record |
|||||||
| 58 | → draft public release |
|||||||
| 59 | → product-owner review |
|||||||
| 60 | → documentation verification |
|||||||
| 61 | → approved canonical release |
|||||||
| 62 | → aethex.us/releases |
|||||||
| 63 | → product changelog |
|||||||
| 64 | → optional Discord or email announcement |
|||||||
| 65 | ``` |
|||||||
| 66 | ||||||||
| 67 | Deployments may create draft release material, but they do not automatically become public releases. |
|||||||
| 68 | ||||||||
| 69 | ## Ownership and scope |
|||||||
| 70 | ||||||||
| 71 | - One Trinity arm is the primary owner; other arms may be contributors. |
|||||||
| 72 | - A cross-Trinity release is one record with multiple contributors, not three duplicated releases. |
|||||||
| 73 | - Shared product changes belong to the shared product. |
|||||||
| 74 | - Customer configuration belongs to that customer or community deployment history. |
|||||||
| 75 | - Infrastructure-only work remains in the engineering log unless it changes public behavior. |
|||||||
| 76 | - Documentation-only work appears in the documentation changelog. |
|||||||
| 77 | ||||||||
| 78 | ## Corrections |
|||||||
| 79 | ||||||||
| 80 | Published history is not silently rewritten. Corrections identify what changed and when. Withdrawn, rolled-back, superseded, and deprecated releases retain their permanent URLs and current state. |
|||||||
| 81 | ||||||||
| 82 | ## Related documentation |
|||||||
| 83 | ||||||||
| 84 | - [[Releases]] |
|||||||
| 85 | - [[Domain Registry]] |
|||||||
| 86 | - [[Changelog]] |
|||||||
| 87 | - [[Release Notes]] |
|||||||
| 88 | - [[Documentation Standards]] |
|||||||