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
|
- **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
|
||||||
|
|||||||
6
GROK.md
6
GROK.md
@ -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 2–4 sentences) that captures the central provocation or thesis. Useful for future indexing, search, and reference tools.
|
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"
|
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: >
|
||||||
|
|||||||
@ -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: >
|
||||||
|
|||||||
@ -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 —
|
||||||
|
|||||||
@ -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
|
||||||
|
|||||||
@ -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 —
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user