The 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 (restricted access)
- Content map (public 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)
- Architecture Repository/Process
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/Contributing ⭐
- 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/Process/Template/Initiative
- Architecture Repository/Process/Template/Narratives
- 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/Patterns/CQRS
- Architecture Repository/Process ⭐
- 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
Navigation
Current
Practice | Strategy | Domain | Systems | Components
Version 1
Remove tabs from navigation
Version 2
Home | Process | Artifacts | Patterns
Prototypes
- Landing page version 1
- Landing page version 2
- What is architecture?
- Artifacts landing page
- Process landing page
Sequence of updates
For specific pages involved in each step, see the content map.
- 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