eblume/blumeops
1
1
Fork 0
Code Issues Pull requests Projects Releases 83 Packages Wiki Activity Actions

Fix towncrier fragment format: use flat <name>.<type>.md

Browse source 
The towncrier config uses the type's `directory` field as the type
identifier in filenames, NOT as subdirectories. Correct format:
  docs/changelog.d/<name>.<type>.md

NOT:
  docs/changelog.d/<type>/<name>.md

- Move fragments to root with type suffix
- Remove empty type subdirectories
- Fix CLAUDE.md instructions
- Fix tutorial examples in contributing.md and ai-assistance-guide.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Erich Blume 2026-02-03 19:06:14 -08:00
commit d0e37b8b91
5 changed files with 13 additions and 13 deletions
Download patch file Download diff file Expand all files Collapse all files

8
CLAUDE.md
View file

@ -37,13 +37,13 @@ Address each unresolved comment before proceeding. The user will resolve comment
4. When making changes, add a towncrier changelog fragment. Use the branch name as the identifier when possible, or use orphan (`+`) otherwise:
```bash
# Using subdirectory (preferred) - type is the directory name
echo "Add new feature X" > docs/changelog.d/feature/new-feature.md
# Using branch name (preferred)
echo "Add new feature X" > docs/changelog.d/new-feature.feature.md
# Orphan fragment (when no branch name fits)
echo "Fix bug Y" > docs/changelog.d/bugfix/+fix-bug-y.md
echo "Fix bug Y" > docs/changelog.d/+fix-bug-y.bugfix.md
```
Fragment types (use as directory name): `feature`, `bugfix`, `infra`, `doc`, `misc`. Fragments are collected into CHANGELOG.md during releases.
Fragment types: `feature`, `bugfix`, `infra`, `doc`, `misc`. Fragments are collected into CHANGELOG.md during releases.
5. Use `Brewfile` and `mise.toml` to install tools needed on the development workstation (typically hostnamed "gilbert", username "eblume").