docs: fix dev docs rendering

[flying-sheep]

• Closes #
• Tests added

• Release note not necessary because: docs change

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 85.48%. Comparing base (f608b87) to head (c1ec5aa).
⚠️ Report is 1 commits behind head on main.
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #2384      +/-   ##
==========================================
- Coverage   87.45%   85.48%   -1.98%     
==========================================
  Files          49       49              
  Lines        7742     7742              
==========================================
- Hits         6771     6618     -153     
- Misses        971     1124     +153     

see 8 files with indirect coverage changes