Repository navigation
Open
Labels
area:documentationmigrate:area:documentationDocs & guidesDocs & guidesmigrate:priority:normalDefault priorityDefault prioritymigrate:status:readyGroomed and ready to startGroomed and ready to startmigrate:type:bugBug or defectBug or defectpriority:normalstatus:readytype:bug
Milestone
Description
Overview
Fix markdown linting errors in the decisions framework document. The document contains complex anchor link references that don't comply with markdown standards.
File
projects/active/repo-restructuring-2026-07-25/DECISIONS_FRAMEWORK-50-QUESTIONS.md
Issues Found (309 total)
Error Categories
-
MD051: Link fragments (200+ instances)
- Problem: Special characters in link targets not properly escaped
- Example:
[#1.-organizational-&-access-patterns]has unescaped&and. - Markdown requires escaping:
[#1\.-organizational-\&-access-patterns]
-
MD029: Ordered list prefix (20+ instances)
- Problem: List numbering doesn't follow sequential pattern
- Example: List shows 1, 2, 4, 5 instead of 1, 2, 3, 4
-
MD012: Multiple blank lines (40+ instances)
- Problem: More than one consecutive blank line found
- Should be at most 1 blank line between sections
-
MD009: Trailing spaces (49+ instances)
- Problem: Lines end with unnecessary whitespace
Solution Options
Option A: Fix all formatting issues
- Escape special characters in link fragments
- Correct list numbering
- Remove trailing spaces
- Remove excess blank lines
Option B: Add linting exceptions
If this document intentionally uses complex link formatting, add to .markdownlintrc.json:
{
"overrides": [
{
"files": ["projects/active/repo-restructuring-2026-07-25/DECISIONS_FRAMEWORK-50-QUESTIONS.md"],
"MD051": false,
"MD029": false
}
]
}Validation
After fixes: npm run lint:md should show 0 errors for this file.
Priority
Medium — Moderate effort, affects CI/CD validation pipeline
Parent Epic
Part of #1507: Pre-existing validation errors cleanup
Definition of Ready (DoR)
- Reproduction steps clearly documented
- Expected vs actual behavior defined
- Environment/version information captured
- Related issues/PRs linked
- Severity/impact assessed
- Acceptance criteria for fix defined
Definition of Done (DoD)
- Bug fix verified and reproduction steps no longer apply
- Root cause identified and documented
- Tests added/updated to prevent regression; CI green
- No new warnings or errors introduced
- Docs/changelog updated
- Backport considered (if applicable)
- Release notes prepared
Metadata
Metadata
Assignees
Labels
area:documentationmigrate:area:documentationDocs & guidesDocs & guidesmigrate:priority:normalDefault priorityDefault prioritymigrate:status:readyGroomed and ready to startGroomed and ready to startmigrate:type:bugBug or defectBug or defectpriority:normalstatus:readytype:bug
Type
Fields
Priority
None yet
Activity
linear-code commentedon Aug 4, 2026
LS-2267
github-actions commentedon Aug 4, 2026
✅ Template check passed after update. Thanks for fixing the issue body.
github-actions commentedon Aug 4, 2026
⏱️ Aging and SLA annotation
Maintained by project-meta-sync workflow.
[-]docs: fix markdown linting errors in DECISIONS_FRAMEWORK document[/-][+]fix: decisions-framework - Resolve Markdown linting errors[/+]github-actions commentedon Sep 8, 2026
This issue has labels that are not in the canonical taxonomy:
migrate:priority:normalmigrate:status:readymigrate:type:bugmigrate:area:documentationValid Canonical Labels
Please use labels with a prefix from the canonical taxonomy:
type:bug,type:feature,type:task,type:documentation, etc.status:needs-triage,status:in-progress,status:done, etc.priority:critical,priority:high,priority:normal,priority:lowarea:ci,area:docs,area:labels,area:security, etc.meta:needs-changelog,meta:duplicate,meta:blocked, etc.For the complete list, see .github/labels.yml.