Documentation: Clarify comments and cleanup in namespace list

[bkoelman]

Clarify comments and move to remarks section to keep the namespace list clean.

Before:

After:

Before:

After:

QUALITY CHECKLIST

• N/A: Changes implemented in code
• Complies with our contributing guidelines
• N/A: Adapted tests
• Documentation updated

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 92.80%. Comparing base (08f849e) to head (898cb0a).
⚠️ Report is 1 commits behind head on master.

Additional details and impacted files

@@           Coverage Diff           @@
##           master    #1818   +/-   ##
=======================================
  Coverage   92.80%   92.80%           
=======================================
  Files         437      437           
  Lines       14809    14809           
  Branches     2388     2388           
=======================================
  Hits        13743    13743           
  Misses        651      651           
  Partials      415      415           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.