Skip to content

feat: Add 'What is NOT a Semantic Anchor?' learning section#92

Merged
raifdmueller merged 1 commit into
LLM-Coding:mainfrom
raifdmueller:main
Feb 14, 2026
Merged

feat: Add 'What is NOT a Semantic Anchor?' learning section#92
raifdmueller merged 1 commit into
LLM-Coding:mainfrom
raifdmueller:main

Conversation

@raifdmueller
Copy link
Copy Markdown
Contributor

Changes

Extended the About page with a comprehensive section explaining what does NOT qualify as a semantic anchor.

New Content

Counter-Examples Table:

  • TLDR, ELI5, "Keep it short", "Best practices", "Modern approach", "Make it simple"
  • Each with clear explanation of why it doesn't qualify

Good vs. Bad Comparisons:
Collapsible section with 3 detailed examples:

  1. Testing: "Write good tests" ❌ vs. "TDD, London School" ✅
  2. Communication: "Keep it short" ❌ vs. "Pyramid Principle" ✅
  3. Code Quality: "Best practices" ❌ vs. "SOLID Principles" ✅

Testing Methodology:

  • How to test if a term qualifies as a semantic anchor
  • Clear checklist of what to look for in LLM responses

Why This Helps

  • New users understand the quality criteria through negative examples
  • Contributors can self-validate before proposing new anchors
  • Clarity on the difference between instructions and semantic anchors
  • Educational value - teaches through comparison

Location

docs/about.adoc - Section added after "Quality Criteria" and before "How to Use This Catalog"

All content is visible on the live About page at #/about

Preview

The section includes:

  • 📊 Comparison table with 6 counter-examples
  • 🔍 Detailed good/bad comparisons (collapsible)
  • ✅ Testing checklist for potential anchors
  • 💡 Key conceptual difference explanation

- Add counter-examples table (TLDR, ELI5, etc.)
- Add comparison: Good vs. Bad examples
- Add testing methodology for potential anchors
- Clarify the key difference between anchors and instructions

Helps users understand quality criteria through negative examples.
@raifdmueller raifdmueller merged commit c76e2b6 into LLM-Coding:main Feb 14, 2026
1 of 2 checks passed
Copilot AI added a commit that referenced this pull request Mar 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant