BED-6531: Restructure information architecture

[jeff-matthews]

Purpose

This pull request (PR) significantly restructures the information architecture for the BloodHound docs site. It's based on an internal wiki page (see BED-6531).

The overall structure is intended to follow typical BloodHound use:

1. Get started (what is this, how do I install it?)
2. Understand the core concepts (attack graphs, privilege zones, OpenGraph)
3. Collect data (set up collectors, run scans, manage schedules)
4. Analyze results (explore, query, posture metrics, accept findings)
5. Manage the platform (users, roles, compliance, security)
6. Extend and reference (API, integrations, schema, glossary)

These changes are important for improving UX now, while also providing a scalable foundation for product growth and evolution.

Note

• I also renamed some files and directories to simplify structure. Redirects will be necessary, but I think we should wait until we've been through some more iterations in case we make more changes. It'll be easier to add final redirects last.
• We will likely need to rewrite some existing content as part of this effort.

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch BED-6531-info-architecture

---

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