Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions .claude/CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,26 @@ Dockerfiles for custom devcontainer images on GitHub Container Registry (ghcr.io
- Standalone: `{primary-version}` only (e.g., `0.11.0`)
- Multi-tool images: `{tool1}{version}-{tool2}{version}` (e.g., `bun1.3.9-hugo0.156.0`)

## Where Documentation Goes

**If a document goes stale when this repo's code changes, it belongs in the repo. If it goes stale when an external system changes — Docker Desktop, GitHub settings, an upstream tool — or it spans several images, it belongs in the [wiki](https://github.com/gatezh/devcontainers/wiki).**

| In the repo | |
|---|---|
| Per-image `README.md` | A tag list or tool table must change in the same commit as its Dockerfile |
| `.claude/CLAUDE.md`, `.claude/rules/*` | Conventions enforced in review |
| `.github/workflows/README.md` | Describes the workflows beside it |
| `docs/plans/`, `docs/superpowers/` | Planning and design artifacts |

| In the wiki | |
|---|---|
| Cross-image guides | Belong to no single image |
| Host / Docker Desktop procedures | Track Docker, not this repo |
| GitHub settings runbooks | Configuration that can't be reviewed in a PR |
| Incident writeups | Operational history, not code |

Never duplicate: wiki pages link to READMEs, READMEs link back. Every wiki page ends with a `## Sources` section citing the PRs/issues it came from and a `*Last verified:*` date.

## Code Style

- 2-space indentation in JSON/YAML
Expand Down
14 changes: 11 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@

This repository contains Dockerfiles for custom Docker images hosted on GitHub Container Registry (ghcr.io).

**New here?** The [wiki](https://github.com/gatezh/devcontainers/wiki) has a [guide to picking an image](https://github.com/gatezh/devcontainers/wiki/Choosing-an-Image) and explains [what `latest` means and when it moves](https://github.com/gatezh/devcontainers/wiki/Image-Tags-and-Rebuild-Policy).

## 📚 Image Documentation

### Devcontainer Images
Expand All @@ -16,10 +18,16 @@ This repository contains Dockerfiles for custom Docker images hosted on GitHub C

- **[ralphex-fe](./ralphex-fe/README.md)** - Bun + Hugo Extended on ralphex base (standalone image)

### Maintenance
## 📖 Guides (wiki)

Cross-image guides and host-level procedures live in the [wiki](https://github.com/gatezh/devcontainers/wiki), because they go stale when Docker or GitHub changes rather than when this repo does.

- **[Docker maintenance cheatsheet](./docs/docker-maintenance-cheatsheet.md)** - commands for "low disk space", a hung Docker, and safe cleanup
- **[Why Docker fills the disk](./docs/disk-usage.md)** - what actually grows, why, and the settings that prevent an outage
- **[Choosing an Image](https://github.com/gatezh/devcontainers/wiki/Choosing-an-Image)** - which of the six images you want
- **[Image Tags and Rebuild Policy](https://github.com/gatezh/devcontainers/wiki/Image-Tags-and-Rebuild-Policy)** - what `latest` means, which tags are immutable, when rebuilds happen
- **[Troubleshooting](https://github.com/gatezh/devcontainers/wiki/Troubleshooting)** - symptoms that span more than one image
- **[Docker Disk Maintenance](https://github.com/gatezh/devcontainers/wiki/Docker-Disk-Maintenance)** - commands for "low disk space", a hung Docker, and safe cleanup
- **[Incident: Docker Disk Exhaustion (2026-09-07)](https://github.com/gatezh/devcontainers/wiki/Incident-Docker-Disk-Exhaustion-2026-09-07)** - what actually grows, why, and the settings that prevent an outage
- **[Branch Protection and Renovate Auto-Merge](https://github.com/gatezh/devcontainers/wiki/Branch-Protection-and-Renovate-Auto-Merge)** - maintainer runbook

## Repository Structure

Expand Down
171 changes: 0 additions & 171 deletions docs/disk-usage.md

This file was deleted.

Loading