docs: rename principles page to 'Design principles'

Docs/pages/00-index.md

@@ -52,7 +52,7 @@ var cup = shop.Resolve<Cup>();       // a fresh cup, wired and ready
 ## Where to go next
 
 - [Getting started](./getting-started) builds your first container end to end.
-- [Principles & the composition root](./principles) is the design behind the mechanics; read it before the feature pages.
+- [Design principles & the composition root](./design-principles) is the design behind the mechanics; read it before the feature pages.
 - [Lifetimes](./registration/lifetimes) explains singleton, scoped, and transient.
 - [Async initialization](./async-initialization) covers the headline feature.
 - [Diagnostics](./diagnostics) lists every compile-time check.

Docs/pages/02-principles.md → Docs/pages/02-design-principles.md

@@ -1,9 +1,10 @@
 ---
-title: Principles & the composition root
+title: Design principles & the composition root
+sidebar_label: Design principles
 sidebar_position: 2
 ---
 
-# Principles & the composition root
+# Design principles & the composition root
 
 The rest of these docs teach the *mechanics*: how to register services, resolve them, and keep their lifetimes honest. This page is about the *design* those mechanics serve. Awaiten enforces the mechanics for you (lifetimes, cycles, async ordering) and turns the ones it can see into build errors. It cannot enforce the design. That part is on you, and it is what this page is for.
 

README.md

@@ -54,7 +54,7 @@ dotnet add package Awaiten
 Full documentation lives at [docs.testably.org/Awaiten](https://docs.testably.org/Awaiten).
 
 - [Getting started](https://docs.testably.org/Awaiten/getting-started)
-- [Principles & the composition root](https://docs.testably.org/Awaiten/principles)
+- [Design principles & the composition root](https://docs.testably.org/Awaiten/design-principles)
 - Registration: [lifetimes](https://docs.testably.org/Awaiten/registration/lifetimes), [factories and instances](https://docs.testably.org/Awaiten/registration/factories-and-instances), [decorators](https://docs.testably.org/Awaiten/registration/decorators), [composites](https://docs.testably.org/Awaiten/registration/composites), [keyed services](https://docs.testably.org/Awaiten/registration/keyed-services), [open generics](https://docs.testably.org/Awaiten/registration/open-generics), [scanning](https://docs.testably.org/Awaiten/registration/scanning), [modules](https://docs.testably.org/Awaiten/registration/modules)
 - Resolution: [resolving services](https://docs.testably.org/Awaiten/resolution/resolving-services), [relationships](https://docs.testably.org/Awaiten/resolution/relationships), [collections](https://docs.testably.org/Awaiten/resolution/collections), [keyed dictionaries](https://docs.testably.org/Awaiten/resolution/keyed-dictionaries), [property injection](https://docs.testably.org/Awaiten/resolution/property-injection), [runtime arguments](https://docs.testably.org/Awaiten/resolution/runtime-arguments), [context-aware factories](https://docs.testably.org/Awaiten/resolution/context-aware-factories)
 - [Async initialization](https://docs.testably.org/Awaiten/async-initialization)