# betaharp/turkce-git-rehberi architecture

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

- Interactive diagram: https://gitdiagram.com/betaharp/turkce-git-rehberi
- Repository: https://github.com/betaharp/turkce-git-rehberi

## Overview

#### Purpose

This repository is a Turkish-language Git usage guide based on official Git documentation. It is a static documentation site, published through GitHub Pages at `https://betaharp.github.io/Turkce-git-rehberi/#/`.

#### Entry Points and Delivery

- Repository-level introduction and publication URL: `README.md`
- Rendered static-site entry document: `docs/index.html`
- Documentation-site-specific notes: `docs/README.md`

GitHub Pages is the material hosting infrastructure; no application server, backend runtime, database, or API integration is represented in the repository tree.

#### Documentation Site Root

The `docs/` directory is the deployable site boundary. Its contents are intended to be served directly as static assets:

- `docs/index.html`
- `docs/.nojekyll`
- `docs/images`

`docs/.nojekyll` indicates Pages should serve the directory without Jekyll processing, preserving the site’s static asset layout and any client-side routing/resource conventions.

#### Content and Presentation Assets

The main HTML document establishes the reader-facing guide experience:

- `docs/index.html`
- `docs/images`

Images are isolated beneath `docs/images`, separating presentation media from the page shell. The supplied tree does not expose separate source-content directories, build scripts, or a package-managed frontend; documentation content is therefore likely embedded or referenced directly by the static site files.

#### Primary Flow

1. A maintainer edits repository documentation or static site files.
2. GitHub Pages publishes the `docs/` site root.
3. A browser requests `docs/index.html` and associated assets under `docs/images`.
4. The guide is rendered entirely client-side/static, with no indicated server-side processing.

The primary architectural boundary is between repository metadata/contributor guidance and the publishable Pages directory.

#### Project Governance and Constraints

- Contribution expectations: `CONTRIBUTING.md`
- Licensing: `LICENSE`
- Git ignore rules: `.gitignore`

These govern repository changes but are outside the runtime delivery path. The project’s operational dependency is GitHub Pages; its content dependency is the official Git documentation described in `README.md`.

Main entry points: [`docs/index.html`](https://github.com/betaharp/turkce-git-rehberi/blob/main/docs/index.html) (Guide Page Shell), [`README.md`](https://github.com/betaharp/turkce-git-rehberi/blob/main/README.md) (Project Overview), [`docs/.nojekyll`](https://github.com/betaharp/turkce-git-rehberi/blob/main/docs/.nojekyll) (Jekyll Bypass), [`docs/images`](https://github.com/betaharp/turkce-git-rehberi/tree/main/docs/images) (Presentation Images)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_repo["Repository"]
  node_maintainer(("Maintainer<br/>actor"))
  node_readme["Project Overview<br/>repository docs<br/>[README.md]"]
  node_contributing["Contribution Guide<br/>governance<br/>[CONTRIBUTING.md]"]
  node_license["License<br/>governance"]
  node_gitignore["Ignore Rules<br/>repository policy<br/>[.gitignore]"]
  node_official_git_docs["Official Git Documentation<br/>content source"]
end

subgraph group_site["Deployable Pages Site"]
  node_docs_readme["Site Notes<br/>site documentation<br/>[README.md]"]
  node_site_root["docs/ Site Root<br/>deployment boundary"]
  node_index["Guide Page Shell<br/>static HTML<br/>[index.html]"]
  node_images["Presentation Images<br/>static assets"]
  node_nojekyll["Jekyll Bypass<br/>Pages marker<br/>[.nojekyll]"]
end

subgraph group_delivery["Publishing"]
  node_github_pages{{"GitHub Pages<br/>static host"}}
  node_browser(("Reader Browser<br/>client"))
end

node_maintainer -->|"edits"| node_readme
node_maintainer -->|"edits"| node_site_root
node_contributing -.->|"guides"| node_maintainer
node_license -.->|"governs"| node_readme
node_gitignore -.->|"applies to changes"| node_maintainer
node_official_git_docs -.->|"content basis"| node_readme
node_official_git_docs -.->|"content basis"| node_index
node_docs_readme -.->|"documents"| node_site_root
node_site_root -->|"contains"| node_index
node_site_root -->|"contains"| node_images
node_site_root -->|"contains"| node_nojekyll
node_index -->|"loads"| node_images
node_nojekyll -.->|"disables Jekyll processing"| node_github_pages
node_site_root -->|"published by"| node_github_pages
node_github_pages -->|"serves static site"| node_browser
node_browser -->|"requests"| node_index

click node_readme "https://github.com/betaharp/turkce-git-rehberi/blob/main/README.md"
click node_contributing "https://github.com/betaharp/turkce-git-rehberi/blob/main/CONTRIBUTING.md"
click node_license "https://github.com/betaharp/turkce-git-rehberi/blob/main/LICENSE"
click node_gitignore "https://github.com/betaharp/turkce-git-rehberi/blob/main/.gitignore"
click node_docs_readme "https://github.com/betaharp/turkce-git-rehberi/blob/main/docs/README.md"
click node_index "https://github.com/betaharp/turkce-git-rehberi/blob/main/docs/index.html"
click node_images "https://github.com/betaharp/turkce-git-rehberi/tree/main/docs/images"
click node_nojekyll "https://github.com/betaharp/turkce-git-rehberi/blob/main/docs/.nojekyll"

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_maintainer,node_readme,node_contributing,node_license,node_gitignore,node_official_git_docs toneBlue
class node_docs_readme,node_site_root,node_index,node_images,node_nojekyll toneAmber
class node_github_pages,node_browser toneMint
```

## Components

### Repository

Source documentation and governance.

- **Maintainer**: actor
- [Project Overview](https://github.com/betaharp/turkce-git-rehberi/blob/main/README.md): repository docs · Introduces the guide and publication URL. · `README.md`
- [Contribution Guide](https://github.com/betaharp/turkce-git-rehberi/blob/main/CONTRIBUTING.md): governance · `CONTRIBUTING.md`
- [License](https://github.com/betaharp/turkce-git-rehberi/blob/main/LICENSE): governance · `LICENSE`
- [Ignore Rules](https://github.com/betaharp/turkce-git-rehberi/blob/main/.gitignore): repository policy · `.gitignore`
- **Official Git Documentation**: content source · Source dependency for the Turkish guide.

### Deployable Pages Site

Static assets served from docs/.

- [Site Notes](https://github.com/betaharp/turkce-git-rehberi/blob/main/docs/README.md): site documentation · `docs/README.md`
- **docs/ Site Root**: deployment boundary · Publishable static-site directory.
- [Guide Page Shell](https://github.com/betaharp/turkce-git-rehberi/blob/main/docs/index.html): static HTML · Reader-facing guide entry document. · `docs/index.html`
- [Presentation Images](https://github.com/betaharp/turkce-git-rehberi/tree/main/docs/images): static assets · `docs/images`
- [Jekyll Bypass](https://github.com/betaharp/turkce-git-rehberi/blob/main/docs/.nojekyll): Pages marker · Keeps the site layout served without Jekyll processing. · `docs/.nojekyll`

### Publishing

GitHub Pages delivery path.

- **GitHub Pages**: static host · Publishes the docs/ directory.
- **Reader Browser**: client · Renders the guide entirely from static assets.

## Connections

- Maintainer → Project Overview: edits
- Maintainer → docs/ Site Root: edits
- Contribution Guide → Maintainer: guides
- License → Project Overview: governs
- Ignore Rules → Maintainer: applies to changes
- Official Git Documentation → Project Overview: content basis
- Official Git Documentation → Guide Page Shell: content basis
- Site Notes → docs/ Site Root: documents
- docs/ Site Root → Guide Page Shell: contains
- docs/ Site Root → Presentation Images: contains
- docs/ Site Root → Jekyll Bypass: contains
- Guide Page Shell → Presentation Images: loads
- Jekyll Bypass → GitHub Pages: disables Jekyll processing
- docs/ Site Root → GitHub Pages: published by
- GitHub Pages → Reader Browser: serves static site
- Reader Browser → Guide Page Shell: requests