Add initial building.mdx file

Author: jenningsanderson

docs/schema/reference/buildings/building.md

@@ -0,0 +1,58 @@
+# Building
+
+A building is a man-made structure with a roof that exists permanently in one
+    place.
+
+    Buildings are compatible with GeoJSON Polygon features.
+
+## Model Information
+
+**Module:** `overture.schema.buildings.building.models`
+**Class:** `Building`
+
+## Fields
+
+| Name | Type | Description |
+|------|------|-------------|
+| `height` | Number (optional) | Height of the building or part in meters. The height is the distance from the lowest point to the highest point. |
+| `is_underground` | Boolean (optional) | Whether the entire building or part is completely below ground. This is useful for rendering which typically omits these buildings or styles them differently because they are not visible above ground. This is different than the level column which is used to indicate z-ordering of elements and negative values may be above ground. |
+| `num_floors` | Integer (optional) | Number of above-ground floors of the building or part. |
+| `num_floors_underground` | Integer (optional) | Number of below-ground floors of the building or part. |
+| `min_height` | Number (optional) | The height of the bottom part of building in meters. Used if a building or part of building starts above the ground level. |
+| `min_floor` | Integer (optional) | The "start" floor of this building or part. Indicates that the building or part is "floating" and its bottom-most floor is above ground level, usually because it is part of a larger building in which some parts do reach down to ground level. An example is a building that has an entry road or driveway at ground level into an interior courtyard, where part of the building bridges above the entry road. This property may sometimes be populated when min_height is missing and in these cases can be used as a proxy for min_height. |
+| `facade_color` | String (optional) | The color (name or color triplet) of the facade of a building or building part in hexadecimal |
+| `facade_material` | FacadeMaterial (optional) | The outer surface material of building facade. |
+| `roof_material` | RoofMaterial (optional) | The outermost material of the roof. |
+| `roof_shape` | RoofShape (optional) | The shape of the roof |
+| `roof_direction` | Number (optional) | Bearing of the roof ridge line in degrees. |
+| `roof_orientation` | RoofOrientation (optional) | Orientation of the roof shape relative to the footprint shape. Either "along" or "across". |
+| `roof_color` | String (optional) | The color (name or color triplet) of the roof of a building or building part in hexadecimal |
+| `roof_height` | Number (optional) | The height of the building roof in meters. This represents the distance from the base of the roof to the highest point of the roof. |
+| `level` | Integer (optional) |  |
+| `names.primary` | String | The most commonly used name. |
+| `names.common` | Map[String, String] (optional) |  |
+| `names.rules[].side` | Side (optional) |  |
+| `names.rules[].between` | Array[Number] (optional) |  |
+| `names.rules[].value` | String |  |
+| `names.rules[].variant` | NameVariant |  |
+| `names.rules[].language` | String (optional) |  |
+| `names.rules[].perspectives.mode` | PerspectiveMode | Whether the perspective holder accepts or disputes this name. |
+| `names.rules[].perspectives.countries` | list | Countries holding the given mode of perspective. |
+| `names.rules[].perspectives` | Perspectives (optional) |  |
+| `names.rules[]` | Array[NameRule] (optional) | Rules for names that cannot be specified in the simple common names property. These rules can cover other name variants such as official, alternate, and short; and they can optionally include geometric scoping (linear referencing) and side-of-road scoping for complex cases. |
+| `names` | Names (optional) |  |
+| `id` | String |  |
+| `theme` | Literal |  |
+| `type` | Literal |  |
+| `geometry` | Geometry | The building's footprint or roofprint (if traced from aerial/satellite imagery). |
+| `version` | Integer |  |
+| `sources[].between` | Array[Number] (optional) |  |
+| `sources[].property` | String |  |
+| `sources[].dataset` | String |  |
+| `sources[].record_id` | String (optional) | Refers to the specific record within the dataset that was used. |
+| `sources[].update_time` | String (optional) |  |
+| `sources[].confidence` | Number (optional) |  |
+| `sources[]` | Array[SourcePropertyItem] (optional) |  |
+| `subtype` | Subtype (optional) |  |
+| `class_` | BuildingClass (optional) |  |
+| `has_parts` | Boolean (optional) | Flag indicating whether the building has parts |