Review contributing tutorial: add last-reviewed, .ai.md fragment type, prek provenance

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Erich Blume 2026-04-21 08:53:41 -07:00
commit 30f39ae050
2 changed files with 7 additions and 4 deletions

View file

@ -0,0 +1 @@
Refresh the contributing tutorial: add `last-reviewed`, include the `.ai.md` changelog fragment type, and clarify that `prek` is pinned via `mise`.

View file

@ -1,6 +1,7 @@
--- ---
title: Contributing title: Contributing
modified: 2026-02-07 modified: 2026-04-21
last-reviewed: 2026-04-21
tags: tags:
- tutorials - tutorials
- contributing - contributing
@ -37,14 +38,14 @@ brew bundle # installs tea, argocd, mise, etc.
### Using Mise (Optional) ### Using Mise (Optional)
Mise manages language toolchains and runs tasks: Mise manages language toolchains, runs tasks, and pins tools like `prek`:
```bash ```bash
mise install # installs Python, Node.js, etc. from mise.toml mise install # installs Python, Node.js, prek, etc. from mise.toml
``` ```
### Git Hooks (prek) ### Git Hooks (prek)
Git hooks validate changes on `git commit`: Git hooks validate changes on `git commit` (prek is pinned in `mise.toml`):
```bash ```bash
prek install prek install
prek run --all-files # verify setup prek run --all-files # verify setup
@ -104,6 +105,7 @@ Fragment types (file suffix):
- `.bugfix.md` - Bug fixes - `.bugfix.md` - Bug fixes
- `.infra.md` - Infrastructure changes - `.infra.md` - Infrastructure changes
- `.doc.md` - Documentation - `.doc.md` - Documentation
- `.ai.md` - AI-assisted changes
- `.misc.md` - Other - `.misc.md` - Other
### 4. Test Your Changes ### 4. Test Your Changes