docs: tidied docs

docs/source/documentation/components.md

@@ -1,27 +1,7 @@
-# HYPERVEHICLE Components
-
-The *hypervehicle* package employs a component build up approach. 
-Using the core component types, a wide range of geometries can 
-be constructed. While there is an upfront cost associated with 
-constructing a good parametric model, the generalised nature of 
-*hypervehicle* allows you to programmatically define relationships 
-between geometric components.
-
-
-## The *hypervehicle* Workflow
-Before diving into the component definitions, this section provides
-an overview of the *hypervehicle* workflow, and how geometries are
-created from arbitrary definitions.
-
-A vehicle is constructed by stacking a collection of *components* 
-together. Each component type defined below inherits from the 
-{py:class}`.Component` class.
-
-Below is a summary of other terminology:
-- Patch: a *patch* is a surface represented by a continuous function
-- Surface: a *surface* is a surface represented by a discrete function
-- Mesh: a *mesh* is a [Numpy STL](https://numpy-stl.readthedocs.io/en/latest/stl.html#stl-mesh) object
+# HyperVehicle Components
 
+As described in the [HyperVehicle overview](overview), a component-based approach is
+used to construct geometries. This page details the base components available.
 
 
 ## General Component Types

docs/source/documentation/overview.md

@@ -0,0 +1,25 @@
+(overview)=
+# Overview of HyperVehicle
+
+The *hypervehicle* package employs a component build up approach. 
+Using the core component types, a wide range of geometries can 
+be constructed. While there is an upfront cost associated with 
+constructing a good parametric model, the generalised nature of 
+*hypervehicle* allows you to programmatically define relationships 
+between geometric components.
+
+
+## The *HyperVehicle* Workflow
+Before diving into the component definitions, this section provides
+an overview of the *hypervehicle* workflow, and how geometries are
+created from arbitrary definitions.
+
+A vehicle is constructed by stacking a collection of *components* 
+together. Each component type defined below inherits from the 
+{py:class}`.Component` class.
+
+Below is a summary of other terminology:
+- Patch: a *patch* is a surface represented by a continuous function
+- Surface: a *surface* is a surface represented by a discrete function
+- Mesh: a *mesh* is a [Numpy STL](https://numpy-stl.readthedocs.io/en/latest/stl.html#stl-mesh) object
+

docs/source/documentation/vehicle.md

@@ -1,4 +1,4 @@
-# Building a Vehicle with *hypervehicle*
+# Building a Vehicle with *HyperVehicle*
 
 Docs coming soon! The following will be addressed:
 - creating a vehicle instance

docs/source/examples/x43.md

@@ -1,6 +1,7 @@
-# Hypervehicle Geometry Generation Example
+# X-43A Demonstrator Tutorial
 
-![X43A Example](../images/hangar/x43a.png)
+<!-- ![X43A Example](../images/hangar/x43a.png) -->
+![X43 Example](../images/x43.gif)
 
 This page covers how to build a parametric model resembling the X-43A
 flight demonstrator.

docs/source/hangar.md

@@ -1,4 +1,4 @@
-# Vehicle Hangar
+# HyperVehicle Hangar
 
 This page is a showcase of vehicle geometries possible using *hypervehicle*.
 Note that all of these vehicles can be accessed via the `hypervehicle.hangar`

docs/source/index.md

@@ -27,7 +27,7 @@ then have a look at the [examples](examples/x43).
 :hidden:
 :caption: SHOWCASE
 
-Vehicle Hangar <hangar>
+Hangar <hangar>
 ```
 
 
@@ -37,9 +37,10 @@ Vehicle Hangar <hangar>
 :caption: DOCUMENTATION
 
 Getting Started <getting-started>
-Building Components <documentation/components>
-Building Vehicles <documentation/vehicle>
-Extracting Sensitivities <documentation/sensitivity>
+Overview <documentation/overview>
+Components <documentation/components>
+Vehicles <documentation/vehicle>
+Parametric Sensitivities <documentation/sensitivity>
 ```
 
 
@@ -50,7 +51,7 @@ Extracting Sensitivities <documentation/sensitivity>
 
 Sharp Wedge <examples/wedge>
 NASA X-43A <examples/x43>
-Parameter Sensitivities <examples/sensitivity>
+Extracting Sensitivities <examples/sensitivity>
 ```