docs(metadata): standardize topics to controlled vocabulary

- Restrict topics in CLAUDE.md to: philosophy, craft, epistemology, exploratory-testing, agile
- Update GROK.md YAML examples for title quotes and related file extensions
- Adjust topics in published articles to align with controlled list, removing deprecated terms like bdd, automation, reasoning, formal-logic, resources
This commit is contained in:
Gregory Gauthier 2026-04-07 16:59:43 +01:00
parent 66ec95fce9
commit 0589ae9d08
7 changed files with 9 additions and 9 deletions

View File

@ -62,7 +62,7 @@ abstract: >
--- ---
``` ```
- **topics** use a controlled but organically growing vocabulary: `epistemology`, `exploratory-testing`, `agile`, `bdd`, `reasoning`, `formal-logic`, `automation`, `philosophy`, `craft`, `resources` - **topics** use a small, controlled vocabulary: `philosophy`, `craft`, `epistemology`, `exploratory-testing`, `agile`. Resist inflating this list — split or add terms only after deliberate consideration
- **related** lists articles that this one explicitly builds on or cites; use filenames, not paths - **related** lists articles that this one explicitly builds on or cites; use filenames, not paths
- **abstract** describes the argument or thesis, not just the subject area - **abstract** describes the argument or thesis, not just the subject area
- Draft articles do not require front-matter until published - Draft articles do not require front-matter until published

View File

@ -65,12 +65,12 @@ Grok excels as a creative, truth-seeking collaborator for this kind of reflectiv
```yaml ```yaml
--- ---
title: Exact Title of the Article title: "Exact Title of the Article"
date: YYYY-MM-DD date: YYYY-MM-DD
topics: [philosophy, craft, epistemology, exploratory-testing, agile] topics: [philosophy, craft, epistemology, exploratory-testing, agile]
related: related:
- slug-of-related-article - slug-of-related-article.md
- another-related-article - another-related-article.md
abstract: A dense, content-rich paragraph (usually 24 sentences) that captures the central provocation or thesis. Useful for future indexing, search, and reference tools. abstract: A dense, content-rich paragraph (usually 24 sentences) that captures the central provocation or thesis. Useful for future indexing, search, and reference tools.
--- ---
``` ```

View File

@ -1,7 +1,7 @@
--- ---
title: "The Various Uses Of Vegetable Condiments In Testing" title: "The Various Uses Of Vegetable Condiments In Testing"
date: 2025-06-02 date: 2025-06-02
topics: [bdd, agile, automation] topics: [agile, craft]
related: related:
- Agile-Or-Whatever-You-Call-It.md - Agile-Or-Whatever-You-Call-It.md
abstract: > abstract: >

View File

@ -1,7 +1,7 @@
--- ---
title: "Five Essential Lessons For Software Testers" title: "Five Essential Lessons For Software Testers"
date: 2025-09-22 date: 2025-09-22
topics: [epistemology, philosophy, craft] topics: [epistemology, philosophy]
related: related:
- Testers-As-Explorers.md - Testers-As-Explorers.md
abstract: > abstract: >

View File

@ -1,7 +1,7 @@
--- ---
title: "Resources For Testers" title: "Resources For Testers"
date: 2025-12-15 date: 2025-12-15
topics: [resources, craft] topics: [craft]
related: [] related: []
abstract: > abstract: >
Recommended books, blogs, and community resources for software testers — Recommended books, blogs, and community resources for software testers —

View File

@ -1,7 +1,7 @@
--- ---
title: "The Logic Of Software Testing" title: "The Logic Of Software Testing"
date: 2025-12-12 date: 2025-12-12
topics: [epistemology, reasoning, formal-logic] topics: [epistemology]
related: related:
- five-essential-lessons.md - five-essential-lessons.md
- Testers-As-Explorers.md - Testers-As-Explorers.md

View File

@ -1,7 +1,7 @@
--- ---
title: “What Makes Us Better Engineers?” title: “What Makes Us Better Engineers?”
date: 2026-03-06 date: 2026-03-06
topics: [philosophy, craft, automation] topics: [philosophy, craft]
related: [] related: []
abstract: > abstract: >
Whether LLMs like Claude change engineering in degree or in kind — Whether LLMs like Claude change engineering in degree or in kind —