Add Province Improvements data and reference page; update navigation and documentation

docs/Province Improvement Data.md

@@ -7,18 +7,22 @@ Each Province Improvement decreases stability by -5.
 
 ---
 
-See Raw Data section
+# Schema
 
-# String
-- Name required: Taken from the Land improvement column. We are just going to ignore the Water improvement and Lava improvements names, because that is flavour that doesn't effect us
+## String
+- **Name** (required): The name of the province improvement. Taken from the Land/Water/Lava improvement column; we use only the single name (ignoring Water/Lava flavour variants).
+- **Category**: The base type/category of the improvement (Conduit, Farm, Forester, Mine, Quarry, Research Post, Teleporter, Monument, etc.).
+- **Effects**: A text description of the main effects. This can include resource bonuses (+X Mana, +X Gold, etc.), adjacent bonuses, terrain effects, and other special mechanics.
+- **Requirements**: A text description of any build requirements (terrain, resource nodes, Town Hall tier, etc.).
+- **Source**: The source/culture/tome that grants this improvement (General, Barbarian, Feudal, High, etc.).
 
-# Int
+## Int
+- **CostProduction**: Production cost to build (from Cost column).
+- **CostGold**: Gold cost to build (from Cost column).
 
-- increaseMana?: from effects column if containing relevant information 
-- increaseFood?: from effects column if containing relevant information
-- inceaseProduction?: from effects column if containing relevant information
-- increaseGold?: from effects column if containing relevant information
-- increaseKnowledge?: from effects column if containing relevant information
+## Notes
+- Base stability penalty: all improvements have -5 Stability
+- See Raw Data sections below for all the improvements by category
 
 
 ---