# swiftlang/swift-evolution architecture

> Architecture diagram of the GitHub repository swiftlang/swift-evolution, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-02-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/swiftlang/swift-evolution
- Repository: https://github.com/swiftlang/swift-evolution

## Overview

##### Main Components

a) Proposal Management System
- Proposals Directory (containing all .md proposal files)
- Proposal Templates
- Release Documentation
- Vision Documents

b) Process Flow Components
- Proposal Submission
- Review Process
- Implementation Tracking
- Release Management

##### Key Relationships to Highlight

- Proposal Flow:
- Template → New Proposal → Review → Implementation → Release
- Version Management:
- Proposals → Release Notes → Version Documentation
- Vision Documents:
- Long-term Goals → Specific Proposals

- Swift Evolution System                                  |

- Templates    |     |    Proposals      |     |    Releases     |     |    Visions    |
- > |                   | --> |                 | <-- |               |
- Swift        |     | - Active          |     | - Changelog     |     | - Embedded    |
- SwiftPM      |     | - Implemented     |     | - Version Docs  |     | - Macros      |
- Rejected        |     +------------------+     | - Testing     |

- ^

- Process Controls  |
- Contributing    |
- Review Process  |

##### Metadata Layer

- Version tracking
- Proposal numbering system
- Cross-reference links between related proposals
- Implementation status tracking

- The systematic nature of Swift's evolution process
- Clear workflow paths from proposal to implementation
- Relationship between proposals and releases
- Long-term vision integration with concrete proposals

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph "Swift Evolution System"
        Templates["Proposal Templates"]
        Proposals["Proposal Management"]
        Releases["Release Documentation"]
        Visions["Vision Documents"]
        Process["Process Controls"]

        subgraph "Template Types"
            SwiftTemp["Swift Template"]
            SwiftPMTemp["SwiftPM Template"]
        end

        subgraph "Proposal States"
            Active["Active Proposals"]
            Implemented["Implemented"]
            Rejected["Rejected"]
        end

        subgraph "Process Documentation"
            Contributing["Contributing Guide"]
            Guidelines["Process Guidelines"]
            Common["Common Proposals"]
        end

        subgraph "Vision Areas"
            Embedded["Embedded Swift"]
            Macros["Macros"]
            Testing["Testing"]
        end
    end

    Templates --> SwiftTemp
    Templates --> SwiftPMTemp
    SwiftTemp --> Proposals
    SwiftPMTemp --> Proposals
    
    Proposals --> Active
    Proposals --> Implemented
    Proposals --> Rejected
    
    Process --> Contributing
    Process --> Guidelines
    Process --> Common
    
    Visions --> Embedded
    Visions --> Macros
    Visions --> Testing
    
    Process --> Proposals
    Visions --> Proposals
    Proposals --> Releases
    Visions --> Releases

    %% Click events for component mapping
    click Proposals "https://github.com/swiftlang/swift-evolution/tree/main//proposals/"
    click Templates "https://github.com/swiftlang/swift-evolution/tree/main//proposal-templates/"
    click SwiftTemp "https://github.com/swiftlang/swift-evolution/blob/main//proposal-templates/0000-swift-template.md"
    click SwiftPMTemp "https://github.com/swiftlang/swift-evolution/blob/main//proposal-templates/0000-swiftpm-template.md"
    click Releases "https://github.com/swiftlang/swift-evolution/tree/main//releases/"
    click Visions "https://github.com/swiftlang/swift-evolution/tree/main//visions/"
    click Contributing "https://github.com/swiftlang/swift-evolution/blob/main//CONTRIBUTING.md"
    click Guidelines "https://github.com/swiftlang/swift-evolution/blob/main//process.md"
    click Common "https://github.com/swiftlang/swift-evolution/blob/main//commonly_proposed.md"

    %% Styling
    classDef default fill:#f9f9f9,stroke:#333,stroke-width:2px
    classDef template fill:#FFE873,stroke:#333
    classDef proposal fill:#9DC3E6,stroke:#333
    classDef vision fill:#D4A6E9,stroke:#333
    classDef process fill:#A8D08D,stroke:#333
    
    class Templates,SwiftTemp,SwiftPMTemp template
    class Proposals,Active,Implemented,Rejected proposal
    class Visions,Embedded,Macros,Testing vision
    class Process,Contributing,Guidelines,Common process
```
