# dotnet/csharplang architecture

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

- Interactive diagram: https://gitdiagram.com/dotnet/csharplang
- Repository: https://github.com/dotnet/csharplang

## Overview

##### Main Components

a) Process Flow Components:
- Discussion Phase (Entry Point)
- Proposal Phase
- Design Phase
- Implementation Phase
- Specification Phase

b) Repository Structure Components:
- Proposals Repository
- Language Design Meeting Records
- Language Specification
- Implementation (External - Roslyn)

##### Key Relationships

a) Process Flows:
- Community Discussion → Champion Selection → Proposal
- Proposal → Language Design Meetings → Design Decisions
- Design Decisions → Implementation Prototypes
- Implementation → Specification Updates

b) Feedback Loops:
- Design Meeting feedback to Proposals
- Implementation feedback to Design
- Community feedback throughout the process

##### Specific Elements

a) Entry Points:
- GitHub Discussions
- Issue Tracking
- Pull Requests

b) Decision Points:
- Language Design Team (LDT) Reviews
- Champion Selection
- Feature Approval

c) Documentation Repositories:
- Proposals Directory
- Meeting Notes
- Specification Documents

##### Implementation Details

- Clear titles
- Status indicators (Working Set, Backlog, Any Time, etc.)
- Version tracking (C# version numbers)
- Links to related components

Top Section:
**[Community Input] → [Discussions] → [Champion Selection]**

Middle Section:
**[Proposals] ↔ [Language Design Meetings] → [Design Decisions]**

Bottom Section:
**[Specification Updates] ← [Implementation (Roslyn)] ← [Prototypes]**

## Diagram (Mermaid)

```mermaid
graph TB
    %% Styles and Classes
    classDef community fill:#90EE90,stroke:#333,stroke-width:2px
    classDef process fill:#ADD8E6,stroke:#333,stroke-width:2px
    classDef documentation fill:#FFB6C1,stroke:#333,stroke-width:2px
    classDef implementation fill:#D3D3D3,stroke:#333,stroke-width:2px
    classDef decision fill:#FFA500,stroke:#333,stroke-width:2px

    %% Community Layer
    subgraph CommunityLayer["Community Interaction Layer"]
        GD["GitHub Discussions"]
        IT["Issue Tracking"]:::community
        PR["Pull Requests"]
        CG["Community Guidelines"]:::community
    end

    %% Design Process Layer
    subgraph DesignLayer["Design Process Layer"]
        DP["Design Process"]:::process
        CS["Champion Selection"]:::decision
        LDM["Language Design Meetings"]:::process
        WG["Working Groups"]:::process
        DD["Design Decisions"]:::decision
    end

    %% Documentation Layer
    subgraph DocLayer["Documentation Layer"]
        PROP["Proposals Repository"]:::documentation
        SPEC["Language Specification"]:::documentation
        MN["Meeting Notes"]:::documentation
        VH["Version History"]:::documentation
    end

    %% Implementation Layer
    subgraph ImplLayer["Implementation Layer"]
        PROTO["Prototypes"]:::implementation
        ROSLYN["Roslyn Implementation"]:::implementation
    end

    %% Relationships
    GD --> CS
    IT --> CS
    PR --> CS
    CS --> PROP
    PROP --> LDM
    LDM --> DD
    DD --> PROTO
    PROTO --> ROSLYN
    ROSLYN --> SPEC
    WG --> LDM
    DD --> SPEC
    LDM --> MN
    
    %% Feedback Loops
    DD -.-> PROP
    ROSLYN -.-> DD
    SPEC -.-> DD

    %% Click Events
    click CG "https://github.com/dotnet/csharplang/blob/main/Communities.md"
    click DP "https://github.com/dotnet/csharplang/blob/main/Design-Process.md"
    click LDM "https://github.com/dotnet/csharplang/tree/main/meetings/"
    click WG "https://github.com/dotnet/csharplang/tree/main/meetings/working-groups/"
    click PROP "https://github.com/dotnet/csharplang/tree/main/proposals/"
    click SPEC "https://github.com/dotnet/csharplang/tree/main/spec/"
    click VH "https://github.com/dotnet/csharplang/blob/main/Language-Version-History.md"
    click IT "https://github.com/dotnet/csharplang/tree/main/.github/ISSUE_TEMPLATE/"

    %% Legend
    subgraph Legend
        L1["Community Components"]:::community
        L2["Process Components"]:::process
        L3["Documentation Components"]:::documentation
        L4["Implementation Components"]:::implementation
        L5["Decision Points"]:::decision
    end
```
