docs(guardrails): enforce JSDoc on every new or modified function#3555

Merged

PierreBrisorgueil merged 12 commits into

docs/enforce-jsdoc-on-functions

Feb 22, 2026

Commits on Feb 22, 2026

docs(guardrails): enforce JSDoc on every new or modified function
PierreBrisorgueil
committed
fix(guardrails): apply Copilot feedback — use @return, clarify async rule, sync copilot-instructions
PierreBrisorgueil
committed
fix(guardrails): add backticks to @param and @return in ERRORS.md for consistent Markdown rendering
PierreBrisorgueil
committed
fix(jsdoc): standardize on @returns (canonical JSDoc tag) across docs and src
PierreBrisorgueil
committed
fix(jsdoc): fix JSDoc accuracy and remove stray /pr reference
PierreBrisorgueil
committed
fix(jsdoc): fix pageRequest @returns description to match actual return value
PierreBrisorgueil
committed
fix(theme): isDark now returns false for 'light', aligns logic with JSDoc
PierreBrisorgueil
committed
fix(theme): isDark accepts boolean and string, fix regression for isDark(true)
PierreBrisorgueil
committed
fix(jsdoc): align ERRORS.md wording with guardrail (new or modified functions)
PierreBrisorgueil
committed
fix(theme): isDark accepts only string, light by default, remove boolean legacy
PierreBrisorgueil
committed
chore(errors): never patch code to pass a test, refactor if needed
PierreBrisorgueil
committed
fix(errors): align ERRORS.md JSDoc rule with guardrail nuance (non-void + async)
PierreBrisorgueil
committed