Skip to content

Commit dbe3eaa

Browse files
DavidLiedleclaude
andcommitted
Scaffold mdBook: SUMMARY, deploy workflow, chapter stubs
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent e1b16b4 commit dbe3eaa

21 files changed

Lines changed: 190 additions & 0 deletions

.github/workflows/deploy.yml

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
name: Deploy mdBook to GitHub Pages
2+
3+
on:
4+
push:
5+
branches: [main]
6+
workflow_dispatch:
7+
8+
permissions:
9+
contents: read
10+
pages: write
11+
id-token: write
12+
13+
concurrency:
14+
group: pages
15+
cancel-in-progress: false
16+
17+
jobs:
18+
build:
19+
runs-on: ubuntu-latest
20+
env:
21+
MDBOOK_VERSION: 0.4.52
22+
steps:
23+
- uses: actions/checkout@v4
24+
- name: Install mdBook
25+
run: |
26+
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/rust-lang/mdBook/releases/download/v${MDBOOK_VERSION}/mdbook-v${MDBOOK_VERSION}-x86_64-unknown-linux-gnu.tar.gz | tar -xz
27+
echo "$PWD" >> $GITHUB_PATH
28+
- name: Build book
29+
run: mdbook build
30+
- uses: actions/configure-pages@v5
31+
- uses: actions/upload-pages-artifact@v3
32+
with:
33+
path: ./book
34+
35+
deploy:
36+
needs: build
37+
runs-on: ubuntu-latest
38+
environment:
39+
name: github-pages
40+
url: ${{ steps.deployment.outputs.page_url }}
41+
steps:
42+
- id: deployment
43+
uses: actions/deploy-pages@v4

.gitignore

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
book/
2+
.DS_Store

README.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
# What We Lost When Unix Won
2+
3+
What We Lost When Unix Won examines the design decisions that became invisible once they became universal. Lisp Machines, Smalltalk, Plan 9, Oberon, BeOS — serious proposals for what computing could be. This book makes those alternatives visible again and asks what's recoverable in 2026.
4+
5+
Built with [mdBook](https://rust-lang.github.io/mdBook/). Licensed CC0.
6+
7+
## Reading
8+
9+
The book is published at <https://cloudstreet-dev.github.io/What-We-Lost-When-Unix-Won/>.
10+
11+
## Building locally
12+
13+
```
14+
mdbook serve --open
15+
```
16+
17+
## License
18+
19+
CC0 1.0 Universal. Use it however you like.

book.toml

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
[book]
2+
title = "What We Lost When Unix Won"
3+
authors = ["CloudStreet"]
4+
description = "A look at the operating systems and computing visions Unix made invisible. Lisp Machines, Smalltalk, Plan 9, Oberon, BeOS — serious proposals for what computing could be, recovered and read in 2026."
5+
language = "en"
6+
multilingual = false
7+
src = "src"
8+
9+
[output.html]
10+
default-theme = "navy"
11+
preferred-dark-theme = "navy"
12+
git-repository-url = "https://github.com/cloudstreet-dev/What-We-Lost-When-Unix-Won"
13+
edit-url-template = "https://github.com/cloudstreet-dev/What-We-Lost-When-Unix-Won/edit/main/{path}"
14+
no-section-label = false
15+
copy-fonts = true
16+
17+
[output.html.fold]
18+
enable = true
19+
level = 1
20+
21+
[output.html.print]
22+
enable = true
23+
24+
[output.html.search]
25+
enable = true
26+
limit-results = 30
27+
use-boolean-and = true
28+
boost-title = 2
29+
boost-hierarchy = 1
30+
boost-paragraph = 1
31+
expand = true
32+
heading-split-level = 3
33+
34+
[rust]
35+
edition = "2021"

src/SUMMARY.md

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
# Summary
2+
3+
[Foreword](./foreword.md)
4+
5+
# Part I — How We Got Here
6+
7+
- [What Won, What It Beat, Why It Won](./ch01-what-won.md)
8+
9+
# Part II — The Lisp Machines
10+
11+
- [Genera and the Image](./ch02-genera.md)
12+
- [The MIT and LMI Lineage](./ch03-mit-lmi.md)
13+
14+
# Part III — The Smalltalk Vision
15+
16+
- [Alan Kay's Actual Proposal](./ch04-kay.md)
17+
- [The Image and Morphic](./ch05-image-morphic.md)
18+
19+
# Part IV — Plan 9 and the Unix That Could Have Been
20+
21+
- [The Bell Labs Second Swing](./ch06-plan9.md)
22+
- [Inferno, Limbo, and the Plan 9 Afterlife](./ch07-inferno.md)
23+
24+
# Part V — The Forgotten Operating Systems
25+
26+
- [Multics — What Unix Was a Reaction Against](./ch08-multics.md)
27+
- [Oberon, BeOS, and the Late Possibilities](./ch09-oberon-beos.md)
28+
29+
# Part VI — The Web as a Second Unix Victory
30+
31+
- [The Browser as the New Shell](./ch10-browser.md)
32+
33+
# Part VII — Survivors and Ghosts
34+
35+
- [Emacs as the Last Lisp Machine in Costume](./ch11-emacs.md)
36+
- [Where the Smalltalk Ideas Live Now](./ch12-smalltalk-now.md)
37+
38+
# Part VIII — Honest Reckoning
39+
40+
- [What's Recoverable, What's Permanently Gone](./ch13-recoverable.md)
41+
42+
[Closing](./closing.md)
43+
[Acknowledgments](./acknowledgments.md)

src/acknowledgments.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# acknowledgments
2+
3+
Stub.

src/ch01-what-won.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# ch01-what-won
2+
3+
Stub.

src/ch02-genera.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# ch02-genera
2+
3+
Stub.

src/ch03-mit-lmi.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# ch03-mit-lmi
2+
3+
Stub.

src/ch04-kay.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# ch04-kay
2+
3+
Stub.

0 commit comments

Comments
 (0)