DOCS: formatting

[jokob-sk]

Summary by CodeRabbit

• Documentation
  • Restructured heading organization in the multi-site monitoring advisory for improved clarity and consistency. All content and information remain unchanged.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: d0a3b56b-74bc-4a99-a3a7-51e184a5e0a7

📥 Commits

Reviewing files that changed from the base of the PR and between 2ca5a80 and 41ccff5.

📒 Files selected for processing (1)

• docs/ADVISORY_MULTI_SITE_MONITORING.md

---

📝 Walkthrough

Walkthrough

This PR adjusts the markdown heading hierarchy in the multi-site monitoring advisory document. Seven section headings are reformatted from top-level to lower-level markdown syntax, restructuring the document's outline while keeping all content, tables, diagrams, and examples intact.

Changes

Documentation Structure Update

Layer / File(s)	Summary
Heading hierarchy restructuring docs/ADVISORY_MULTI_SITE_MONITORING.md	All seven section headings (Architecture Overview, Sync Modes, Device Ownership Models, Example Deployment, Recommended MSP Features, Related Documentation, and Summary) are demoted to lower-level markdown heading levels, adjusting the document's table-of-contents structure without altering any descriptive content or nested elements.

Possibly related PRs

• netalertx/NetAlertX#1658: Introduced the multi-site monitoring advisory document that this PR reformats.

Poem

A rabbit hops through docs with care,
Adjusting headings here and there,
From top-level down, the outline flows,
The structure clear where content grows. 🐰✨

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'DOCS: formatting' is directly related to the changeset, which only modifies markdown heading formatting in a documentation file without altering content.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch next_release

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[jokob-sk]

@coderabbitai add learning that all .md files must have only one H1 entry (one # heading) otherwise teh navigation in the docs breaks

[coderabbitai]

Tip

For best results, initiate chat on the files or code changes.

@jokob-sk: Got it! I've noted this rule for future reviews.

(ᵔᴥᵔ)🐇📝

---

✏️ Learnings added

Learnt from: jokob-sk
URL: https://github.com/netalertx/NetAlertX/pull/1668

Timestamp: 2026-06-02T23:16:59.163Z
Learning: In the NetAlertX repository (https://github.com/netalertx/NetAlertX), all Markdown (.md) files must have exactly one H1 heading (a single line starting with `#`). Having more than one H1 heading breaks the navigation in the docs.

Note: Learnings are effective only in the context of similar code segments. To apply general coding guidelines, please configure review instructions. You can manage existing learnings in the app.