[Docs] Reposition Vision/Mission and consolidate audience sections

README.md

@@ -36,13 +36,14 @@ Untold Engine is an **open-source Swift/Metal XR engine for
 high-performance Apple-platform spatial visualization apps**, giving
 developers full control over rendering, shaders, and the engine pipeline.
 
-**Vision:** An engine that empowers creativity and never stands in its way.
+Creator & Lead Developer:  
+https://www.haroldserrano.com
 
-**Mission:** Build a reliable engine that lets developers focus on creating,
-not troubleshooting the tools they depend on.
+![archviz-demo](docs/images/gifs/archviz-demo.gif)
+
+---
 
-Want to help build it? Our [Engineering Principles](ENGINEERING_PRINCIPLES.md)
-show you how we work — join us.
+## Built For
 
 Untold Engine is built for developers and teams who:
 
@@ -52,21 +53,11 @@ Untold Engine is built for developers and teams who:
 - Need to handle **large scenes, streaming data, or custom asset pipelines**
 - Want an open engine they can inspect, modify, extend, and embed
 
-Creator & Lead Developer:  
-https://www.haroldserrano.com
-
-![archviz-demo](docs/images/gifs/archviz-demo.gif)
-
----
-
-## Built For
-
-Untold Engine is designed for developers building custom spatial visualization
-software on Apple platforms, including:
+Common use cases include:
 
-- Vision Pro and spatial computing apps
-- Architectural walkthroughs and large-scene visualizers
-- Custom rendering pipelines and research prototypes
+- Vision Pro and ARKit-based spatial computing apps
+- Architectural walkthroughs and large-scale scene visualizers (interiors, archviz, cities, datasets)
+- Custom rendering pipelines and graphics research prototypes
 
 The engine owns the rendering and XR foundation. Your app owns the vertical
 workflow, product experience, and customer-specific behavior.
@@ -171,6 +162,11 @@ not currently available, see [Commercial Use, Sponsored Features, and Support](C
 
 ## Core Direction
 
+**Vision:** An engine that empowers creativity and never stands in its way.
+
+**Mission:** Build a reliable engine that lets developers focus on creating,
+not troubleshooting the tools they depend on.
+
 Untold Engine is built around three focused goals:
 
 - **Spatial Engine First** — Designed for spatial computing applications. LOD, geometry streaming, and static batching exist to support large, real-world-scale environments where presence and performance both matter.
@@ -181,16 +177,6 @@ Untold Engine is built around three focused goals:
 
 ---
 
-## Example Use Cases
-
-Untold Engine is well-suited for:
-
-- Vision Pro and ARKit-based visualization apps
-- Large-scale scene visualization: interiors, archviz, cities, datasets
-- Custom rendering pipelines and graphics experiments
-
----
-
 # Current Features
 
 - **Apple Platform Coverage** — Unified Swift + Metal codebase for macOS, iOS, and visionOS

docs/index.md

@@ -21,13 +21,14 @@ Untold Engine is an **open-source Swift/Metal XR engine for
 high-performance Apple-platform spatial visualization apps**, giving
 developers full control over rendering, shaders, and the engine pipeline.
 
-**Vision:** An engine that empowers creativity and never stands in its way.
+Creator & Lead Developer:  
+[Harold Serrano](http://www.haroldserrano.com)
 
-**Mission:** Build a reliable engine that lets developers focus on creating,
-not troubleshooting the tools they depend on.
+![archviz-demo](images/gifs/archviz-demo.gif)
+
+---
 
-Want to help build it? Our [Engineering Principles](https://github.com/untoldengine/UntoldEngine/blob/main/ENGINEERING_PRINCIPLES.md)
-show you how we work — join us.
+## Built For
 
 Untold Engine is built for developers and teams who:
 
@@ -37,21 +38,11 @@ Untold Engine is built for developers and teams who:
 - Need to handle **large scenes, streaming data, or custom asset pipelines**
 - Want an open engine they can inspect, modify, extend, and embed
 
-Creator & Lead Developer:  
-[Harold Serrano](http://www.haroldserrano.com)
-
-![archviz-demo](images/gifs/archviz-demo.gif)
-
----
-
-## Built For
-
-Untold Engine is designed for developers building custom spatial visualization
-software on Apple platforms, including:
+Common use cases include:
 
-- Vision Pro and spatial computing apps
-- Architectural walkthroughs and large-scene visualizers
-- Custom rendering pipelines and research prototypes
+- Vision Pro and ARKit-based spatial computing apps
+- Architectural walkthroughs and large-scale scene visualizers (interiors, archviz, cities, datasets)
+- Custom rendering pipelines and graphics research prototypes
 
 The engine owns the rendering and XR foundation. Your app owns the vertical
 workflow, product experience, and customer-specific behavior.
@@ -132,6 +123,11 @@ To create your own XR, 3D, or spatial visualization app using Untold Engine, see
 
 ## Core Direction
 
+**Vision:** An engine that empowers creativity and never stands in its way.
+
+**Mission:** Build a reliable engine that lets developers focus on creating,
+not troubleshooting the tools they depend on.
+
 Untold Engine is built around three focused goals:
 
 - **Spatial Engine First** — Designed for spatial computing applications. LOD, geometry streaming, and static batching exist to support large, real-world-scale environments where presence and performance both matter.
@@ -142,16 +138,6 @@ Untold Engine is built around three focused goals:
 
 ---
 
-## Example Use Cases
-
-Untold Engine is well-suited for:
-
-- Vision Pro and ARKit-based visualization apps
-- Large-scale scene visualization: interiors, archviz, cities, datasets
-- Custom rendering pipelines and graphics experiments
-
----
-
 # Current Features
 
 - **Apple Platform Coverage** — Unified Swift + Metal codebase for macOS, iOS, and visionOS