Explanation

Understanding-oriented documentation that clarifies concepts and design decisions.

Explanations help you understand why the bridge simulator works the way it does. These guides focus on concepts, context, and the reasoning behind design decisions.

System Understanding

System Architecture

Learn how all the bridge components work together as a unified system.

Key concepts: - Component relationships and data flow - Scalability and modularity principles - Performance considerations - System reliability and fault tolerance

Networking

Understand the network design and communication protocols.

Key concepts: - Why WiFi vs. ethernet matters - Security considerations and best practices - Performance optimization strategies - Protocol design decisions

Hardware Philosophy

Device Compatibility

Understand why different devices work and how to choose the best options.

Key concepts: - Compatibility principles and requirements - Performance trade-offs between device types - Future-proofing your hardware choices - When to upgrade vs. when existing hardware works

Design Principles

Learn about the philosophy and goals that guide the project.

Key concepts: - Why we prioritize existing hardware over new purchases - Open source and community principles - User experience design goals - Technical architecture decisions

When to Read Explanations

After tutorials: To understand why you did what you did
Before major decisions: To make informed choices about hardware/setup
When contributing: To understand the project's direction
When troubleshooting: To understand root causes vs. quick fixes

Need step-by-step learning? → See Tutorials
Need to solve a specific problem? → See How-to Guides
Need technical details? → See Reference