# pic16b/git-practice architecture

> Architecture diagram of the GitHub repository pic16b/git-practice, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pic16b/git-practice
- Repository: https://github.com/pic16b/git-practice

## Overview

This repository is a tutorial, not a software runtime: its product is a guided introduction to Git and GitHub workflows. The principal path is fork and clone, make and commit local changes, push them to GitHub, then pull a remote change. The README also teaches plotting in a notebook and two recovery methods: discard uncommitted edits and revert a committed change. All repository components below refer to the README; relationships are documented there, not inferred from source code.

Main entry points: [`README.md`](https://github.com/pic16b/git-practice/blob/main/README.md) (Local repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Repository setup"]
  node_github["GitHub"]
  node_desktop["GitHub Desktop"]
  node_fork["Fork repository<br/>[README.md]"]
  node_clone["Local clone<br/>[README.md]"]
end

subgraph group_changes["Change and sync"]
  node_localrepo["Local repository<br/>[README.md]"]
  node_edit["Edit README<br/>[README.md]"]
  node_notebook["Create plot notebook<br/>[README.md]"]
  node_commit["Commit changes<br/>[README.md]"]
  node_push["Push commits<br/>[README.md]"]
  node_inspect["Inspect hosted files<br/>[README.md]"]
  node_remoteedit["Edit on GitHub<br/>[README.md]"]
  node_pull["Fetch and pull<br/>[README.md]"]
end

subgraph group_recovery["Undo changes"]
  node_discard["Discard edits<br/>[README.md]"]
  node_revert["Revert commit<br/>[README.md]"]
end

node_learner(("Learner"))

node_learner -->|"creates fork"| node_fork
node_fork -->|"copies repository"| node_github
node_learner -->|"opens in"| node_clone
node_clone -->|"uses"| node_desktop
node_learner -->|"edits locally"| node_edit
node_learner -->|"creates"| node_notebook
node_edit -->|"changes file in"| node_localrepo
node_notebook -->|"saves file in"| node_localrepo
node_learner -->|"stages and commits"| node_commit
node_commit -->|"records change in"| node_localrepo
node_learner -->|"pushes with"| node_push
node_push -->|"uses"| node_desktop
node_desktop -->|"pushes commits to"| node_github
node_learner -->|"views"| node_inspect
node_inspect -->|"checks hosted files"| node_github
node_learner -->|"edits remotely"| node_remoteedit
node_remoteedit -->|"commits edit on"| node_github
node_learner -->|"pulls with"| node_pull
node_pull -->|"uses"| node_desktop
node_pull -->|"incorporates remote change"| node_localrepo
node_learner -->|"discards via"| node_discard
node_discard -->|"uses"| node_desktop
node_learner -->|"reverts via"| node_revert
node_revert -->|"uses"| node_desktop

click node_fork "https://github.com/pic16b/git-practice/blob/main/README.md"
click node_clone "https://github.com/pic16b/git-practice/blob/main/README.md"
click node_localrepo "https://github.com/pic16b/git-practice/blob/main/README.md"
click node_edit "https://github.com/pic16b/git-practice/blob/main/README.md"
click node_notebook "https://github.com/pic16b/git-practice/blob/main/README.md"
click node_commit "https://github.com/pic16b/git-practice/blob/main/README.md"
click node_push "https://github.com/pic16b/git-practice/blob/main/README.md"
click node_inspect "https://github.com/pic16b/git-practice/blob/main/README.md"
click node_remoteedit "https://github.com/pic16b/git-practice/blob/main/README.md"
click node_pull "https://github.com/pic16b/git-practice/blob/main/README.md"
click node_discard "https://github.com/pic16b/git-practice/blob/main/README.md"
click node_revert "https://github.com/pic16b/git-practice/blob/main/README.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_github,node_desktop,node_fork,node_clone toneBlue
class node_localrepo,node_edit,node_notebook,node_commit,node_push,node_inspect,node_remoteedit,node_pull toneAmber
class node_discard,node_revert toneMint
class node_learner toneIndigo
```

## Components

### Repository setup

- **GitHub**
- **GitHub Desktop**
- [Fork repository](https://github.com/pic16b/git-practice/blob/main/README.md): `README.md`
- [Local clone](https://github.com/pic16b/git-practice/blob/main/README.md): `README.md`

### Change and sync

- [Local repository](https://github.com/pic16b/git-practice/blob/main/README.md): `README.md`
- [Edit README](https://github.com/pic16b/git-practice/blob/main/README.md): `README.md`
- [Create plot notebook](https://github.com/pic16b/git-practice/blob/main/README.md): `README.md`
- [Commit changes](https://github.com/pic16b/git-practice/blob/main/README.md): `README.md`
- [Push commits](https://github.com/pic16b/git-practice/blob/main/README.md): `README.md`
- [Inspect hosted files](https://github.com/pic16b/git-practice/blob/main/README.md): `README.md`
- [Edit on GitHub](https://github.com/pic16b/git-practice/blob/main/README.md): `README.md`
- [Fetch and pull](https://github.com/pic16b/git-practice/blob/main/README.md): `README.md`

### Undo changes

- [Discard edits](https://github.com/pic16b/git-practice/blob/main/README.md): `README.md`
- [Revert commit](https://github.com/pic16b/git-practice/blob/main/README.md): `README.md`

### Other components

- **Learner**

## Connections

- Learner → Fork repository: creates fork (evidence: `README.md`)
- Fork repository → GitHub: copies repository (evidence: `README.md`)
- Learner → Local clone: opens in (evidence: `README.md`)
- Local clone → GitHub Desktop: uses (evidence: `README.md`)
- Learner → Edit README: edits locally (evidence: `README.md`)
- Learner → Create plot notebook: creates (evidence: `README.md`)
- Edit README → Local repository: changes file in (evidence: `README.md`)
- Create plot notebook → Local repository: saves file in (evidence: `README.md`)
- Learner → Commit changes: stages and commits (evidence: `README.md`)
- Commit changes → Local repository: records change in (evidence: `README.md`)
- Learner → Push commits: pushes with (evidence: `README.md`)
- Push commits → GitHub Desktop: uses (evidence: `README.md`)
- GitHub Desktop → GitHub: pushes commits to (evidence: `README.md`)
- Learner → Inspect hosted files: views (evidence: `README.md`)
- Inspect hosted files → GitHub: checks hosted files (evidence: `README.md`)
- Learner → Edit on GitHub: edits remotely (evidence: `README.md`)
- Edit on GitHub → GitHub: commits edit on (evidence: `README.md`)
- Learner → Fetch and pull: pulls with (evidence: `README.md`)
- Fetch and pull → GitHub Desktop: uses (evidence: `README.md`)
- Fetch and pull → Local repository: incorporates remote change (evidence: `README.md`)
- Learner → Discard edits: discards via (evidence: `README.md`)
- Discard edits → GitHub Desktop: uses (evidence: `README.md`)
- Learner → Revert commit: reverts via (evidence: `README.md`)
- Revert commit → GitHub Desktop: uses (evidence: `README.md`)
