take a pass adding in marketing language

DEVELOPING.md

@@ -49,6 +49,12 @@ zensical serve
 
 Navigation is fully defined in [zensical.toml](./zensical.toml).
 
+The current information architecture is intentionally audience-based:
+
+- `Home`, `Platform`, and `Solutions` are the business-facing front of the site.
+- `Developers` is the technical back of the site.
+- Existing CALYPR product docs and open-source tool docs keep their URLs, but they should not be treated as the main marketing entry point.
+
 If you want to:
 
 - rename a sidebar label
@@ -69,11 +75,16 @@ These live in `docs/` and should be edited directly there.
 Examples:
 
 - `docs/index.md`
+- `docs/platform/...`
+- `docs/solutions/...`
+- `docs/developers/index.md`
 - `docs/calypr/...`
 - `docs/tools/index.md`
 - `docs/tools/funnel/...`
 - `docs/tools/grip/...`
 
+Business-facing pages should explain outcomes first and link to developer docs second. Avoid making command references, protocol names, or implementation components the first thing a non-technical reader has to understand.
+
 ### Imported tool pages
 
 These are not authored in this repo anymore.