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:
parent
66ec95fce9
commit
0589ae9d08
@ -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
|
||||
- **abstract** describes the argument or thesis, not just the subject area
|
||||
- Draft articles do not require front-matter until published
|
||||
|
||||
6
GROK.md
6
GROK.md
@ -65,12 +65,12 @@ Grok excels as a creative, truth-seeking collaborator for this kind of reflectiv
|
||||
|
||||
```yaml
|
||||
---
|
||||
title: Exact Title of the Article
|
||||
title: "Exact Title of the Article"
|
||||
date: YYYY-MM-DD
|
||||
topics: [philosophy, craft, epistemology, exploratory-testing, agile]
|
||||
related:
|
||||
- slug-of-related-article
|
||||
- another-related-article
|
||||
- slug-of-related-article.md
|
||||
- another-related-article.md
|
||||
abstract: A dense, content-rich paragraph (usually 2–4 sentences) that captures the central provocation or thesis. Useful for future indexing, search, and reference tools.
|
||||
---
|
||||
```
|
||||
|
||||
@ -1,7 +1,7 @@
|
||||
---
|
||||
title: "The Various Uses Of Vegetable Condiments In Testing"
|
||||
date: 2025-06-02
|
||||
topics: [bdd, agile, automation]
|
||||
topics: [agile, craft]
|
||||
related:
|
||||
- Agile-Or-Whatever-You-Call-It.md
|
||||
abstract: >
|
||||
|
||||
@ -1,7 +1,7 @@
|
||||
---
|
||||
title: "Five Essential Lessons For Software Testers"
|
||||
date: 2025-09-22
|
||||
topics: [epistemology, philosophy, craft]
|
||||
topics: [epistemology, philosophy]
|
||||
related:
|
||||
- Testers-As-Explorers.md
|
||||
abstract: >
|
||||
|
||||
@ -1,7 +1,7 @@
|
||||
---
|
||||
title: "Resources For Testers"
|
||||
date: 2025-12-15
|
||||
topics: [resources, craft]
|
||||
topics: [craft]
|
||||
related: []
|
||||
abstract: >
|
||||
Recommended books, blogs, and community resources for software testers —
|
||||
|
||||
@ -1,7 +1,7 @@
|
||||
---
|
||||
title: "The Logic Of Software Testing"
|
||||
date: 2025-12-12
|
||||
topics: [epistemology, reasoning, formal-logic]
|
||||
topics: [epistemology]
|
||||
related:
|
||||
- five-essential-lessons.md
|
||||
- Testers-As-Explorers.md
|
||||
|
||||
@ -1,7 +1,7 @@
|
||||
---
|
||||
title: “What Makes Us Better Engineers?”
|
||||
date: 2026-03-06
|
||||
topics: [philosophy, craft, automation]
|
||||
topics: [philosophy, craft]
|
||||
related: []
|
||||
abstract: >
|
||||
Whether LLMs like Claude change engineering in degree or in kind —
|
||||
|
||||
Loading…
Reference in New Issue
Block a user