Add network automation section

[afritzler]

Summary by CodeRabbit

• Documentation
  • Added a top-level Network Automation section (overview, getting started, key features: discovery, provisioning, configuration) and linked it in navigation and hero actions.
  • Expanded sidebar with Network Automation content and adjusted navigation entries.
  • Renamed "Bare Metal Automation" to "Bare Metal Management" across guides, headings, diagrams, API references, and overview content.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

Fixes #104

[coderabbitai]

Walkthrough

Adds a new "Network Automation" documentation section with a top-level nav item and sidebar, introduces docs/network-automation/index.md as an overview of Kubernetes-based network automation, and renames occurrences of "Bare Metal Automation" to "Bare Metal Management" across multiple docs and diagrams.

Changes

Cohort / File(s)	Summary
Documentation navigation config docs/.vitepress/config.mts	Adds a top-level "Network Automation" nav entry and sidebar group, and renames nav/sidebar labels from "Bare Metal Automation" to "Bare Metal Management".
New Network Automation content docs/network-automation/index.md	Adds an overview page describing a Kubernetes-based network automation architecture, key features (Device Discovery, Provisioning, Configuration Management), getting-started notes, and a network-operator component reference.
Bare Metal docs (terminology updates) docs/baremetal/index.md, docs/baremetal/architecture/index.md, docs/baremetal/api-references/index.md	Replaces "Bare Metal Automation" with "Bare Metal Management" in headings, prose, and an architecture diagram caption/path.
Top-level and overview pages docs/index.md, docs/overview/index.md	Updates hero text and tagline to include "Bare Metal Management" and "Network Automation"; replaces Bare Metal Automation references and diagrams with Bare Metal Management variants; introduces Network Automation section and diagram.
IaaS docs reference update docs/iaas/architecture/os-images.md	Single-line rename reference from "Bare Metal Automation" to "Bare Metal Management".

Sequence Diagram(s)

(omitted)

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (2 warnings)

Check name	Status	Explanation	Resolution
Description check	⚠️ Warning	The description only provides 'Fixes #104' without detailing the proposed changes, missing the required structure of the template with bullet points explaining the modifications.	Expand the description to include the 'Proposed Changes' section with bullet points explaining what was added (network automation docs, navigation updates, terminology changes).
Out of Scope Changes check	⚠️ Warning	Beyond the primary network automation addition, the PR includes extensive terminology changes from 'Bare Metal Automation' to 'Bare Metal Management' across multiple files, which extends beyond the stated objective of issue #104.	Consider whether terminology changes should be in a separate PR or clarify if they're part of the linked issue's scope. Document the reasoning for these additional changes in the PR description.

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'Add network automation section' directly reflects the main objective of adding a new network automation documentation section, which is the primary change across multiple files.
Linked Issues check	✅ Passed	The pull request successfully implements the linked issue #104 objective by adding a network automation section with documentation, sidebar entries, and references to network-operator.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

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

✨ Finishing touches

• 📝 Generate docstrings

---

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.}

[coderabbitai]

Actionable comments posted: 1

🤖 Fix all issues with AI agents

In `@docs/network-automation/index.md`:
- Around line 6-11: The document jumps from h1 to h3 headings ("Key Features"
and "Getting Started"); change those h3 headings (the lines containing "### Key
Features" and "### Getting Started") to h2 (use "##") so heading levels
increment by one and comply with MD001 and accessibility/navigation best
practices.

[afritzler]

@swagner-de @felix-kaestner I added here an initial section for the network automation topic and cross referenced the network-operator. Feel free to open up any followup PRs to extend this doc section here.

[felix-kaestner]

Thanks @afritzler! Looks good from my side.

[coderabbitai]

Actionable comments posted: 1

🤖 Fix all issues with AI agents

In `@docs/overview/index.md`:
- Line 27: Replace the bold label "**Bare Metal Management**" (and the other
bold label "**Network Automation**") with proper Markdown headings to satisfy
MD036; for example change "**Bare Metal Management**" to "### Bare Metal
Management" (and similarly "**Network Automation**" to "### Network Automation")
so they become structured headings rather than bold text.

[coderabbitai]

Actionable comments posted: 2

🤖 Fix all issues with AI agents

In `@docs/overview/index.md`:
- Around line 87-89: The bullet "Day 2 Operations: Manage configurations,
updates, and compliance for network devices" is missing a terminal period;
update that list item so it ends with a period to match the surrounding bullets
(e.g., modify the "Day 2 Operations" line in the list to add a trailing "." so
all three bullets are punctuated consistently).
- Around line 9-10: The sentence describing "IronCore’s two layers" uses a
singular verb; update the sentence so the verb agrees with the plural subject
(e.g., change "belongs to the infrastructure management domain" to "belong to
the infrastructure management domain") and ensure the parallel clause for the
IaaS layer likewise uses "provide" as shown in the diff to keep tense/number
consistent.

🧹 Nitpick comments (1)

docs/baremetal/index.md (1)

10-10: Use “support for” (grammar tweak).

“with support of” is unidiomatic; “with support for” reads better.

✏️ Proposed tweak

-- **Kubernetes Support**: Run Kubernetes on bare metal servers with support of Cluster API and Gardener.
+- **Kubernetes Support**: Run Kubernetes on bare metal servers with support for Cluster API and Gardener.