diff options
| author | Owen Jacobson <owen@grimoire.ca> | 2023-12-18 19:41:51 -0500 |
|---|---|---|
| committer | Owen Jacobson <owen@grimoire.ca> | 2024-01-03 03:05:23 -0500 |
| commit | 5562e320736812d1ad309cfaf73383512a87858d (patch) | |
| tree | d93569bd8831f4ea5b90719a61a9d1b217e76b0f /docs/git/index.md | |
| parent | 27d5717529bf0e7d5806982f1970603bad998eaf (diff) | |
Migrate to Hugo.
This is a big and somewhat complicated decision, but the crux of it is this:
The _mkdocs_ tool embeds a ton of "I am writing a manual" assumptions about document structure.
These assumptions include that there is a single, sitewide TOC, that a top nav bar is broadly an appropriate way to skip around in the document, and numerous others. They serve that use case well, but that's not really what this site _is_, or how I intend it to be approached. I'm trying for something more blog-esque (and deliberately a bit haphazard).
Hugo is an experiment. This commit migrates most pages to it, but it does drop a few; this is a convenient excuse to forget items I'd prefer not to continue publishing.
Diffstat (limited to 'docs/git/index.md')
| -rw-r--r-- | docs/git/index.md | 14 |
1 files changed, 0 insertions, 14 deletions
diff --git a/docs/git/index.md b/docs/git/index.md deleted file mode 100644 index 5cfc4d8..0000000 --- a/docs/git/index.md +++ /dev/null @@ -1,14 +0,0 @@ -# Collected Advice about Git - -* [git-config Settings You Want](config.md) — Git is highly configurable, and the defaults have gotten drastically better over the years, but there are still some non-default behaviours that I've found make life better. - -* [Notes Towards Detached Signatures in Git](detached-sigs.md) — An idea I had, but never fully developed, for implementing after-the-fact object signing on top of Git. This was based on a similar feature in Monotone, which I'd found very effective for annotating commits on the fly. - -* [Life With Pull Requests](pull-request-workflow.md) — Some notes I made while getting up to speed with pull requests to help my team come to grips with the workflows. - -* [Git Is Not Magic](scratch.md) — An exploration of Git's on-disk data structures and the design choices taken very early in Git's existence. - -* [Stop using `git pull` for deployment!](stop-using-git-pull-to-deploy.md) — Describing the least-painful way to use Git as a deployment tool I had worked out, circa 2014. Written in an aversarial style as a response to repeated ”why don't we just”s that, while well-intentioned, came from an incomplete understanding of what `git pull` does. - -* [Git Survival Guide](survival.md) — Some words of caution about Git, `git`'s preferred workflows, and various recoverable mistakes. - |