Link and TOC fixes

Author: schnuerle

agency/README.md

@@ -70,8 +70,9 @@ See the [GBFS Requirement](/README.md#gbfs-requirement) language for more detail
 
 The `/vehicles` endpoint returns the specified vehicle (if a device_id is provided) or a list of known vehicles. Providers can only retrieve data for vehicles in their registered fleet. Contains vehicle properties that do not change often.
 
-Endpoint: `/vehicles/{device_id}`
-Method: `GET`
+**Endpoint**: `/vehicles/{device_id}`  
+**Method:** `POST`  
+**Payload:** An array of [Vehicles](/data-types.md#vehicles)  
 
 Path Params:
 
@@ -105,8 +106,9 @@ _No content returned on vehicle not found._
 
 The `/vehicles/status` endpoint returns information about the specified vehicle (if a device_id is provided) or a list of known vehicles current state. Providers can only retrieve data for vehicles in their registered fleet. Contains specific vehicle properties that are updated frequently.
 
-Endpoint: `/vehicles/status/{device_id}`
-Method: `GET`
+**Endpoint**: `/vehicles/status/{device_id}`  
+**Method:** `POST`  
+**Payload:** An array of [Vehicles](/data-types.md#vehicle-status) objects  
 
 Path Params:
 
@@ -214,7 +216,7 @@ The vehicle `/telemetry` endpoint allows a Provider to send vehicle telemetry da
 
 **Endpoint**: `/telemetry`  
 **Method**: `POST`  
-**Payload**: An array of [Vehicle Telemetry][vehicle-telemetry]  
+**Payload**: An array of vehicle [Telemetry][vehicle-telemetry]  
 
 200 Success Response:
 

data-types.md

@@ -7,7 +7,7 @@ This MDS data types page catalogs the objects (fields, types, requirements, desc
 - [Vehicles](#vehicles)
   - [Vehicle Types](#vehicle-types)
   - [Propulsion Types](#propulsion-types)
-- [Vehicle Status](#vehicle-status)
+  - [Vehicle Status](#vehicle-status)
 - [Events](#events)
   - [Event Types](#event-times)
 - [Telemetry](#telemetry)
@@ -65,7 +65,7 @@ A vehicle may have one or more values from the `propulsion`, depending on the nu
 
 [Top][toc]
 
-## Vehicle Status 
+### Vehicle Status 
 
 A vehicle status record represents the current or last-known event and telemetry from a vehicle, defined as follows:
 
@@ -113,7 +113,7 @@ A standard point of vehicle telemetry. References to latitude and longitude impl
 
 | Field             | Type            | Required/Optional      | Field Description |
 | -----             | ----            | -----------------      | ----------------- |
-| `device_id`       | UUID            | Required               | ID used in [Register](#vehicle---register)                     |
+| `device_id`       | UUID            | Required               | A unique device ID in UUID format                     |
 | `provider_id`     | UUID            | Required               | A UUID for the Provider, unique within MDS. See MDS [provider list](/providers.csv). |
 | `data_provider_id`| UUID            | Optional               | If different than `provider_id`, a UUID for the data solution provider managing the data feed in this endpoint. See MDS [provider list](/providers.csv) which includes both service operators and data solution providers. |
 | `telemetry_id`    | UUID            | Required               | ID used for uniquely-identifying a Telemetry entry |

provider/README.md

@@ -221,8 +221,8 @@ The `/vehicles/status` endpoint returns the specified vehicle (if a device_id is
 **Endpoint:** `/vehicles/status/{device_id}`  
 **Method:** `GET`  
 **[Beta feature][beta]:** No (as of 1.2.0)  
-**Schema:** [`vehicles-status` schema][vehicles-status-schema]  
-**`data` Payload:** `{ "vehicles": [] }`, an array of [Vehicle Status](vehicle-status) objects
+**Schema:** N/A
+**`data` Payload:** `{ "vehicles": [] }`, an array of [Vehicle Status][vehicle-status] objects
 
 Path Params:
 
@@ -325,7 +325,7 @@ Unless stated otherwise by the municipality, this endpoint must return only thos
 **Endpoint:** `/telemetry`  
 **Method:** `GET`  
 **Schema:** [`telemetry` schema][telemetry-schema]  
-**`data` Payload:** `{ "telemetry": [] }`, an array of `telemetry` objects
+**`data` Payload:** `{ "telemetry": [] }`, an array of [Vehicle Telemetry][vehicle-telemetry] objects
 
 [Top][toc]
 
@@ -345,13 +345,13 @@ The `/events/recent` and `/events/historical/` endpoints return a list of Event
 
 Unless stated otherwise by the municipality, this endpoint must return only those status changes with a `event_location` that [intersects](#intersection-operation) with the [municipality boundary](#municipality-boundary).
 
-> Note: As a result of this definition, consumers should query the [trips endpoint][trips] to infer when vehicles enter or leave the municipality boundary.
+> Note: As a result of this definition, consumers should query the [trips endpoint](#trips) to infer when vehicles enter or leave the municipality boundary.
 
 **Endpoint:** `/events/historical`  
 **Method:** `GET`  
 **[Beta feature][beta]:** No  
 **Schema:** [`events` schema][events-schema]  
-**`data` Payload:** `{ "data": [] }`, an array of [Vehicle Event Data](#vehicle-event-data)
+**`data` Payload:** `{ "data": [] }`, an array of [Events](/data-types.md#events) object
 
 [Top][toc]
 
@@ -402,7 +402,7 @@ See also [Stop-based Geographic Data][stop-based-geo].
 **Method:** `GET`  
 **[Beta feature][beta]:** No (as of 1.0.0)  
 **Schema:** [`events` schema][events-schema]  
-**`data` Payload:** `{ "events": [] }`, an array of Event objects
+**`data` Payload:** `{ "events": [] }`, an array of [Events](/data-types.md#events) object objects
 
 #### Recent Events - Query Parameters
 
@@ -493,7 +493,7 @@ See [Provider examples](examples.md#reports).
 [json-schema]: https://json-schema.org
 [muni-boundary]: #municipality-boundary
 [mode]: /modes/README.md
-[point-geo]: /general-information.md#geographic-telemetry-data
+[point-geo]: /data-types.md#gps-data
 [propulsion-types]: /general-information.md#propulsion-types
 [responses]: /general-information.md#responses
 [stops]: /data-types.md#stops
@@ -515,4 +515,5 @@ See [Provider examples](examples.md#reports).
 [vehicle-events]: /modes#event-types
 [vehicle-event-data]: /general-information.md#event-data
 [vehicles-schema]: vehicles.json
+[vehicle-telemetry]: /data-types.md#telemetry
 [versioning]: /general-information.md#versioning