Skip to content

Commit 98ff554

Browse files
jgelukclaude
andcommitted
docs(concept): simplify "Required facts" headings to concept names
Remove redundant "Required facts about" prefix from headings since they're already under a "## Facts" section. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 6e1ef9c commit 98ff554

File tree

14 files changed

+14
-14
lines changed

14 files changed

+14
-14
lines changed

docs/concept/concept/concept-vocabulary.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -404,7 +404,7 @@ domain, enabling reuse and consistency across use cases_
404404
- Clear traceability of which terms are considered equivalent in
405405
which contexts
406406

407-
### Required facts
407+
### Concept Vocabulary
408408

409409
- **Identifier**
410410
- A Concept Vocabulary must have an **opaque**, **universally

docs/concept/concept/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -249,7 +249,7 @@ reason about business concepts_
249249
minimal facts you can use to build your own ontology, schema,
250250
or graph model.
251251

252-
### Required facts about a Concept
252+
### Concept
253253

254254
- **Opaque universally unique identifier**
255255
- A Concept must have an **opaque**, **universally unique** identifier.

docs/concept/concept/story-concept-relationship.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@ or dependent)_
5959
minimal facts you can use to build your own ontology, schema,
6060
or graph model.
6161

62-
### Required facts about a Story/Concept Relationship
62+
### Story/Concept Relationship
6363
- **Opaque universally unique identifier**: A UUID representing this specific relationship instance.
6464
- **Source Story**: A reference to the [Story](../story.md) that owns this relationship.
6565
- **Target Concept**: A reference to the [Concept](index.md) being used.

docs/concept/outcome/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -212,7 +212,7 @@ requirement_
212212
minimal facts you can use to build your own ontology, schema,
213213
or graph model.
214214

215-
### Required facts about an Outcome
215+
### Outcome
216216

217217
- **Opaque universally unique identifier**
218218
- An Outcome should have an **opaque**, **universally unique**

docs/concept/outcome/outcome-relationship.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,7 @@ contribution mapping_
6565
minimal facts you can use to build your own ontology, schema,
6666
or graph model.
6767

68-
### Required facts about an Outcome Relationship
68+
### Outcome Relationship
6969
- **Opaque universally unique identifier**: A UUID representing
7070
this relationship instance.
7171
- **Source Use Case**: A reference to the [Use

docs/concept/outcome/outcome-stereotype.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -425,7 +425,7 @@ Goals, Objectives, KPIs, and Success Criteria_
425425

426426
An Outcome Stereotype is a classification applied to an Outcome:
427427

428-
### Required facts
428+
### Outcome Stereotype
429429

430430
- **Outcome** must reference zero or one **Outcome Stereotype**
431431
- **Outcome Stereotype** has a **name** (e.g., "Goal",

docs/concept/persona/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -230,7 +230,7 @@ or entities — involved in a Use Case, defined using business language_
230230
minimal facts you can use to build your own ontology, schema,
231231
or graph model.
232232

233-
### Required facts about a Persona
233+
### Persona
234234

235235
- **Opaque universally unique identifier**
236236
- A Persona should have an **opaque**, **universally unique** identifier.

docs/concept/persona/persona-taxonomy.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@ Scheme within a Use Case_
5959
minimal facts you can use to build your own ontology, schema,
6060
or graph model.
6161

62-
### Required facts about a Persona Taxonomy
62+
### Persona Taxonomy
6363
- **Opaque universally unique identifier**: A UUID representing this taxonomy.
6464
- **SKOS Concept Scheme**: Modeled as `skos:ConceptScheme`.
6565
- **Owned by Use Case**: A reference to the [Use Case](../use-case/index.md) that owns it (zero or one cardinality).

docs/concept/story.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -218,7 +218,7 @@ defines what a Persona needs to accomplish within a Use Case_
218218
minimal facts you can use to build your own ontology, schema,
219219
or graph model.
220220

221-
### Required facts about a Story
221+
### Story
222222

223223
- **Opaque universally unique identifier**
224224
- A Story must have an **opaque**, **universally unique** identifier.

docs/concept/term/business-term.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,7 @@ policies_
6565
minimal facts you can use to build your own ontology, schema,
6666
or graph model.
6767

68-
### Required facts about a Business Term
68+
### Business Term
6969
- **Inherits from Term**: All facts required for a [Term](index.md#ontology) (UUID, lexical forms, ownership) apply here.
7070
- **Term Kind**: Must be identified as a "Business Term".
7171
- **Language**: Should include a natural language tag (e.g., `en`, `nl`).

0 commit comments

Comments
 (0)