docs: remove horizontal rules to follow own guidelines
Remove all --- section separators to comply with Universal Formatting Rules. The ## headers provide sufficient visual separation. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
parent
1f859c2378
commit
fbfbbb0f16
|
|
@ -215,8 +215,6 @@ your-project/
|
||||||
```
|
```
|
||||||
````
|
````
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Document Types
|
## Document Types
|
||||||
|
|
||||||
Select document type based on reader goal:
|
Select document type based on reader goal:
|
||||||
|
|
@ -229,8 +227,6 @@ Select document type based on reader goal:
|
||||||
| Look up information | Reference |
|
| Look up information | Reference |
|
||||||
| Find term definitions | Glossary |
|
| Find term definitions | Glossary |
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Tutorial Structure
|
## Tutorial Structure
|
||||||
|
|
||||||
Tutorials teach complete workflows to new users. Length: 200-400 lines.
|
Tutorials teach complete workflows to new users. Length: 200-400 lines.
|
||||||
|
|
@ -266,8 +262,6 @@ Tutorials teach complete workflows to new users. Length: 200-400 lines.
|
||||||
- [ ] Getting Help section present
|
- [ ] Getting Help section present
|
||||||
- [ ] Key Takeaways admonition at end
|
- [ ] Key Takeaways admonition at end
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## How-To Structure
|
## How-To Structure
|
||||||
|
|
||||||
How-to guides complete specific tasks for users who know basics. Length: 50-150 lines (shorter than tutorials, assumes prior knowledge).
|
How-to guides complete specific tasks for users who know basics. Length: 50-150 lines (shorter than tutorials, assumes prior knowledge).
|
||||||
|
|
@ -307,8 +301,6 @@ Guidelines:
|
||||||
- [ ] Steps are numbered `###` subsections with action verbs
|
- [ ] Steps are numbered `###` subsections with action verbs
|
||||||
- [ ] "What You Get" describes output artifacts
|
- [ ] "What You Get" describes output artifacts
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Explanation Structure
|
## Explanation Structure
|
||||||
|
|
||||||
Explanation documents answer "What is X?" and "Why does X matter?"
|
Explanation documents answer "What is X?" and "Why does X matter?"
|
||||||
|
|
@ -396,8 +388,6 @@ Explanation documents answer "What is X?" and "Why does X matter?"
|
||||||
- [ ] Links to how-to guides for procedural questions
|
- [ ] Links to how-to guides for procedural questions
|
||||||
- [ ] 2-3 admonitions max per document (1-2 per section)
|
- [ ] 2-3 admonitions max per document (1-2 per section)
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Reference Structure
|
## Reference Structure
|
||||||
|
|
||||||
Reference documents answer "What are the options?" and "What does X do?" for users who know what they need.
|
Reference documents answer "What are the options?" and "What does X do?" for users who know what they need.
|
||||||
|
|
@ -486,8 +476,6 @@ Guidelines:
|
||||||
- [ ] Links to explanation docs for conceptual depth
|
- [ ] Links to explanation docs for conceptual depth
|
||||||
- [ ] 1-2 admonitions max
|
- [ ] 1-2 admonitions max
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Glossary Structure
|
## Glossary Structure
|
||||||
|
|
||||||
Glossaries provide compact, scannable term definitions.
|
Glossaries provide compact, scannable term definitions.
|
||||||
|
|
@ -559,8 +547,6 @@ Reference category anchor (terms are not headers):
|
||||||
- [ ] Term names bolded in cells
|
- [ ] Term names bolded in cells
|
||||||
- [ ] No "A [term] is..." definitions
|
- [ ] No "A [term] is..." definitions
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## FAQ Sections
|
## FAQ Sections
|
||||||
|
|
||||||
Structure:
|
Structure:
|
||||||
|
|
@ -588,8 +574,6 @@ Rules:
|
||||||
- Direct answers (no `**A:**` prefix)
|
- Direct answers (no `**A:**` prefix)
|
||||||
- End with CTA for unanswered questions
|
- End with CTA for unanswered questions
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Validation Steps
|
## Validation Steps
|
||||||
|
|
||||||
Before submitting documentation changes, run from repo root:
|
Before submitting documentation changes, run from repo root:
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue