The [[ https://www.mediawiki.org/wiki/Architecture_Repository | Architecture Repository ]] is a collection of documents related to system architecture at the Wikimedia Foundation. It was originally designed by Diana Montalion and Alex Paskulin in February 2021. As of September 2022, it consists of a landing page and 44 subpages, about half of which are placeholders or navigation pages. Pageviews on all pages have been minimal for the past year. The Architecture Team wants to re-organize the Repository to highlight the most important content.
- [Original meeting notes](https://docs.google.com/document/d/1r9ovQbyAxklbuvR29tfq562R9MaGkdyXa_3xAS3Jl30/edit) (restricted access)
- [Content map](https://docs.google.com/spreadsheets/d/1q2LEU-WqqL05nH4GDAS27W0Jpu0yfMvGpzGWeZ2tGo4/edit#gid=0) (restricted access)
## Content types
- **Architecture process**: describes what architecture is and how it works in practice at WMF
- **Architecture artifact**: describes a Wikimedia system
- **Architecture pattern**: describes a general, reusable solution to a commonly occurring problem in system architecture
- **Product narrative**: describes a hypothetical scenario enabled by a Wikimedia system (Version 1 only)
- Wiki organization and maintenance
- **Landing page**: serves as a navigation tool between related pages
- **Maintainer guide**: describes how to maintain the Architecture Repository itself
- **Skeleton**: used for creating standard document structures for the Architecture Repository
## Proposed structure
### Version 1
- Architecture Repository
- Architecture Repository/Process
- Architecture Repository/Process/... (to be determined)
- Architecture Repository/Artifacts
- Architecture Repository/Artifacts/Abstract Wikipedia Architecture
- Architecture Repository/Artifacts/Enabling strategic product goals with architecture patterns
- Architecture Repository/Artifacts/Phoenix books
- Architecture Repository/Artifacts/Structured content proof of value
- Architecture Repository/Artifacts/Knowledge store
- Architecture Repository/Artifacts/Evolving towards a target architecture
- Architecture Repository/Artifacts/Wikimedia technical systems: Architecture analysis
- Architecture Repository/Patterns
- Architecture Repository/Patterns/Loose coupling
- Architecture Repository/Patterns/Canonical data modeling
- Architecture Repository/Patterns/Event-based interactions
- Architecture Repository/Narratives
- Architecture Repository/Narratives/Fighting disinformation and misinformation
- Architecture Repository/Narratives/Campaigns
- Architecture Repository/Narratives/New editor experiences: Creating an article
- Architecture Repository/Narratives/New editor experiences: Editing citations
- Architecture Repository/Narratives/Wikipedia in the classroom
- Architecture Repository/Maintainers
- Architecture Repository/Maintainers/... (to be determined)
### Version 2
Minimum refresh that highlights existing content and can be implemented immediately without any additional work by the team
⭐ = Linked from homepage
- Architecture Repository
- Architecture Repository/Process ⭐
- Architecture Repository/Process/What is system architecture? ⭐
- Architecture Repository/Process/Services for projects and teams ⭐
- Architecture Repository/Process/How to use these docs ⭐
- Architecture Repository/Process/Template
- Architecture Repository/Process/Architecture practice
- Architecture Repository/Process/Heuristics
- Architecture Repository/Process/Maturity model
- Architecture Repository/Process/Resources
- Architecture Repository/Process/Glossary and toolset
- Architecture Repository/Artifacts ⭐
- Architecture Repository/Artifacts/Abstract Wikipedia Architecture ⭐
- Architecture Repository/Artifacts/Enabling strategic product goals with architecture patterns ⭐
- Architecture Repository/Artifacts/Structured content proof of value ⭐
- Architecture Repository/Artifacts/Knowledge store ⭐
- Architecture Repository/Artifacts/Wikimedia technical systems: Architecture analysis ⭐
- Architecture Repository/Artifacts/Phoenix books
- Architecture Repository/Artifacts/Evolving towards a target architecture
- Architecture Repository/Patterns ⭐
- Architecture Repository/Patterns/Loose coupling
- Architecture Repository/Patterns/Canonical data modeling
- Architecture Repository/Patterns/Event-based interactions
- Architecture Repository/Strategy/Narratives/Campaigns
- Architecture Repository/Strategy/Narratives/Fighting disinformation and misinformation
- Architecture Repository/Strategy/Narratives/New editor experiences: Creating an article
- Architecture Repository/Strategy/Narratives/New editor experiences: Editing citations
- Architecture Repository/Strategy/Narratives/Wikipedia in the classroom
- Architecture Repository/About/Template/Initiative (Marked as historical)
- Architecture Repository/About/Template/Narratives (Marked as historical)
## Navigation
### Current
Practice | Strategy | Domain | Systems | Components
### Version 1
Remove tabs from navigation
### Version 2
Home | Process | Artifacts | Patterns
## Prototypes
- [Landing page version 1](https://www.mediawiki.org/wiki/User:APaskulin_(WMF)/Sandbox/Arch_landing)
- [Landing page version 2](https://www.mediawiki.org/wiki/User:APaskulin_(WMF)/Sandbox/Arch_landing2)
## Sequence of updates
For specific pages involved in each step, see the [content map](https://docs.google.com/spreadsheets/d/1q2LEU-WqqL05nH4GDAS27W0Jpu0yfMvGpzGWeZ2tGo4/edit#gid=0) (restricted access).
- Phase 1
- Create missing pages
- Update landing page
- Phase 2
- Move existing pages to new locations
- Fix transclusions
- Fix templates
- Fix links
- Fix create-page buttons
- Fix links on homepage
- Update navigation
- Phase 3
- Mark pages for deletion