Revision Policy
All SUNNY M Lab Phenomena Atlas entries are published as versioned working definitions. They are subject to revision when new evidence, boundary cases, or clearer observational frameworks emerge.
When Revisions Occur
A term may be revised when:
- New batch evidence changes or refines the definition
- A boundary case is identified that clarifies the term's scope
- A common misreading becomes frequent enough to require explicit correction
- A relationship with another phenomenon becomes clearer or changes
- A better observational framework is developed that changes how the phenomenon is described
- The Observer Protocol is updated in a way that affects observation standards for the term
Version Format
v1.0 Initial public definition. Term has been observed across multiple batches and meets Atlas entry criteria.
v1.1 Minor clarification. Language refined, additional examples added, or observable conditions described more precisely. No conceptual change.
v1.2+ Additional minor revisions. Boundary conditions or relationship descriptions updated based on new observations.
v2.0 Major conceptual revision. The definition, observable conditions, or core framework of the term has changed substantially. Previous version should be noted.
What Each Page Records
Each Phenomena Atlas page includes:
- pubDate — the date the term was first formally documented
- updatedDate — the date of the most recent revision
- version — the current version number
- revisionNotes — a summary of what changed and why, when applicable
Research Status Progression
Research status reflects the confidence level in a term, separate from the version number:
- Initial Observation — pattern recognized, documentation beginning
- Active Documentation — accumulating evidence across batches
- Repeated Batch Confirmed — pattern confirmed across multiple batches
- Multi-Origin Confirmed — confirmed across different coffee origins
- Archive Stable — sufficient evidence; definition unlikely to change substantially
- Deprecated Observation — superseded or replaced by a more precise term
Deprecated Terms
If a term is deprecated, the original page will remain accessible with a deprecation notice indicating which term supersedes it and why the revision was made. Deprecated terms are not deleted — they remain as part of the research history.