start fleshing out accompanying website

[?]

Aug 31, 2025, 4:25 PM

TY3KJNK4BBGOMFKUUSLIZFIW2Q2SSRXGOHJOOH6DITAAXCE3XKFAC

Dependencies

[2] PBSUHZ5C start building lesson with mdbook
[3] NBZNA6YI add mystmd configuration
[4] WQOLDV5Z initial commit: README.md
[5] HME56U35 start building slides in org-mode
[6] PWHMRB3A move slides to separate folder

Change contents

file deletion: book.toml (----------)

[4.2]→[2.5419912:5419945](∅→∅),[2.5419945]→[2.5419813:5419813](∅→∅)

[book]
authors = ["Jez Cope"]
language = "en"
src = "src"
title = "Workshop: Git without GitHub"
file deletion: overview.md (----------)

[2.1]→[2.5418564:5418599](∅→∅),[2.5418599]→[2.5418551:5418551](∅→∅)

# Overview
file deletion: github.md (----------)

[2.1]→[2.5418815:5418848](∅→∅),[2.5418848]→[2.5418601:5418601](∅→∅)

# Why consider alternatives?

First off, I want to make absolutely clear that I attach no shame or judgement to

## Monocultures are fragile

## Git is distributed by design

## It's good to have backup options
file addition: parts (d--r------)

[4.2]
file addition: footer.md (----------)

[0.192]

Collaborative Git without GitHub © 2025 by [Jez Cope](https://erambler.co.uk/about) is licensed under [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/).
replacement in myst.yml at line 5

[3.310]→[3.310:338](∅→∅)

# title:
# description:

[3.310]

[3.338]

title: Collaborative Git without GitHub
description: A smol workshop
replacement in myst.yml at line 8

[3.355]→[3.355:371](∅→∅)

# authors: []

[3.355]

[3.371]

authors:
- Jez Cope
license: CC-BY-SA-4.0
edit in myst.yml at line 12

[3.383]→[3.383:452](∅→∅)

# To autogenerate a Table of Contents, run "myst init --write-toc"
edit in myst.yml at line 13

[3.459]→[3.459:507](∅→∅)

# Auto-generated by `myst init --write-toc`
replacement in myst.yml at line 14

[3.529]→[3.529:583](∅→∅)

- file: src/overview.md
- file: src/github.md

[3.529]

[3.583]

- file: content/overview.md
- file: content/github.md
replacement in myst.yml at line 19

[3.617]→[3.617:630](∅→∅)

# options:

[3.617]

[3.630]

parts:
footer: parts/footer.md
options:
replacement in myst.yml at line 23

[3.657]→[3.657:683](∅→∅)

# logo: site_logo.png

[3.657]

logo: assets/icons/git.svg
logo_text: Git without GitHub
file addition: content (d--r------)

[4.2]
file addition: overview.md (----------)

[0.721]

# Overview

:::{note}
This workshop and accompanying materials are a work in progress!
:::
file addition: github.md (----------)

[0.721]

# A critical approach to tools

First off, I want to make absolutely clear that there no shame in using GitHub. I use it, you probably do too. Maybe it's required for you to get paid. Maybe it's used by an open project or community you contribute to.

## Why worry?

### Monocultures are fragile

### Git is distributed by design

### It's good to have backup options

## What are we trying to replace?

:::{exercise} How do you work?
:label: github-uses

- What do you use GitHub for?
- If you *don't* use it: what do you use instead?
- What features do you use?
- What would you miss most/least if it wasn't there?
:::

:::{solution} github-uses


Don't worry, there's no "right" answer here! Here are a few things you might have come up with:

Issues
: Reporting and discussing bugs, feature requests and other

Pull requests

:::

## Hosted options

### Codeberg

-

### Sourcehut

### GitLab

### BitBucket
file addition: assets (d--r------)

[4.2]
file addition: icons (d--r------)

[0.1853]
file addition: git.svg (----------)

[0.1873]

<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 640 640"><path d="M535.6 300.1L340 104.5C334.6 99 327.2 96 319.6 96C312 96 304.6 99 299.2 104.4L258.5 145L310 196.5C337.1 187.4 362.7 213.3 353.4 240.2L403.1 289.9C437.3 278.1 464.3 320.9 438.6 346.6C412.1 373.1 368.4 343.7 382.6 309.3L336.3 263L336.3 384.9C361.6 397.4 358.6 426.7 345.4 439.9C339 446.3 330.2 450 321.1 450C312 450 303.3 446.4 296.8 439.9C279.2 422.3 285.7 393 308 383.9L308 260.9C287.2 252.4 283.4 230.2 289.4 215.9L238.6 165L104.5 299.1C99 304.6 96 311.9 96 319.5C96 327.1 99 334.5 104.5 339.9L300.1 535.6C305.5 541 312.8 544 320.5 544C328.2 544 335.5 541 340.9 535.6L535.6 340.9C541 335.5 544 328.1 544 320.5C544 312.9 541 305.5 535.6 300.1z"/></svg>