docs(lane_change): use json schema

Signed-off-by: Zulfaqar Azmi <zulfaqar.azmi@tier4.jp>

Author: zulfaqar-azmi-t4

planning/behavior_path_planner/autoware_behavior_path_lane_change_module/README.md

@@ -1044,16 +1044,7 @@ The following parameters are used to configure terminal lane change path feature
 
 The following parameters are configurable in `lane_change.param.yaml`.
 
-| Name                                   | Unit    | Type    | Description                                                                                                      | Default value |
-| :------------------------------------- | ------- | ------- | ---------------------------------------------------------------------------------------------------------------- | ------------- |
-| `cancel.enable_on_prepare_phase`       | [-]     | boolean | Enable cancel lane change                                                                                        | true          |
-| `cancel.enable_on_lane_changing_phase` | [-]     | boolean | Enable abort lane change.                                                                                        | false         |
-| `cancel.delta_time`                    | [s]     | double  | The time taken to start steering to return to the center line.                                                   | 3.0           |
-| `cancel.duration`                      | [s]     | double  | The time taken to complete returning to the center line.                                                         | 3.0           |
-| `cancel.max_lateral_jerk`              | [m/sss] | double  | The maximum lateral jerk for abort path                                                                          | 1000.0        |
-| `cancel.overhang_tolerance`            | [m]     | double  | Lane change cancel is prohibited if the vehicle head exceeds the lane boundary more than this tolerance distance | 0.0           |
-| `cancel.unsafe_hysteresis_threshold`   | [-]     | int     | threshold that helps prevent frequent switching between safe and unsafe decisions                                | 10            |
-| `cancel.deceleration_sampling_num`     | [-]     | int     | Number of deceleration patterns to check safety to cancel lane change                                            | 5             |
+{{ json_to_markdown("planning/behavior_path_planner/autoware_behavior_path_lane_change_module/schema/lane_change_abort.schema.json") }}
 
 ### Debug
 

planning/behavior_path_planner/autoware_behavior_path_lane_change_module/schema/lane_change_abort.schema.json

@@ -0,0 +1,96 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "lane_change_abort",
+  "type": "object",
+  "definitions": {
+    "behavior_path_lane_change_module": {
+      "type": "object",
+      "properties": {
+        "cancel": {
+          "type": "object",
+          "properties": {
+            "enable_on_prepare_phase": {
+              "type": "boolean",
+              "description": "Enable cancel lane change.",
+              "units": "/",
+              "default": "true",
+            },
+            "enable_on_lane_changing_phase": {
+              "type": "boolean",
+              "description": "Enable abort lane change.",
+              "units": "/",
+              "default": "true",
+            },
+            "overhang_tolerance": {
+              "type": "number",
+              "description": "threshold to determine ego vehicle diverges from current lane.",
+              "units": "s",
+              "default": 0.0,
+              "minimum": 0.0
+            },
+            "delta_time": {
+              "type": "number",
+              "description": "The time taken to start steering to return to the center line.",
+              "units": "s",
+              "default": 2.0,
+              "minimum": 1.0,
+              "maximum": 3.0
+            },
+            "duration": {
+              "type": "number",
+              "description": "The time taken to complete returning to the center line.",
+              "units": "s",
+              "default": 2.0,
+              "minimum": 1.0,
+              "maximum": 3.0
+            },
+            "max_lateral_jerk": {
+              "type": "number",
+              "description": "The maximum lateral jerk for abort path.",
+              "units": "m/s3",
+              "default": 1000.0
+            },
+            "unsafe_hysteresis_threshold": {
+              "type": "integer",
+              "description": "threshold to determine ego vehicle diverges from current lane.",
+              "units": "/",
+              "default": 5,
+              "minimum": 1
+            },
+            "deceleration_sampling_num": {
+              "type": "integer",
+              "description": "threshold to determine ego vehicle diverges from current lane.",
+              "units": "/",
+              "default": 5,
+              "minimum": 1
+            },
+          },
+          "required": ["enable_on_prepare_phase", "enable_on_lane_changing_phase", "overhang_tolerance", "delta_time", "duration", "max_lateral_jerk", "unsafe_hysteresis_threshold", "deceleration_sampling_num"],
+          "additionalProperties": false
+        },
+      },
+      "required": ["cancel"],
+      "additionalProperties": false
+    }
+  },
+  "properties": {
+    "/**": {
+      "properties": {
+        "ros__parameters": {
+          "type": "object",
+          "properties": {
+            "avoidance": {
+              "$ref": "#/definitions/behavior_path_lane_change_module"
+            }
+          },
+          "required": ["lane_change"],
+          "additionalProperties": false
+        }
+      },
+      "required": ["ros__parameters"],
+      "additionalProperties": false
+    }
+  },
+  "required": ["/**"],
+  "additionalProperties": false
+}