Add rolling stock, effort curve documentation

editoast/editoast_schemas/src/rolling_stock/effort_curves.rs

@@ -76,9 +76,11 @@ pub struct EffortCurveConditions {
 pub struct EffortCurve {
     #[derivative(Hash(hash_with = "editoast_common::hash_float_slice::<3,_>"))]
     #[schema(min_items = 2, example = json!([0.0, 2.958, 46.719]))]
+    /// Speeds in m/s. Must contains the same number of elements as `max_efforts`
     speeds: Vec<f64>,
     #[derivative(Hash(hash_with = "editoast_common::hash_float_slice::<3,_>"))]
     #[schema(min_items = 2, example = json!([23500.0, 23200.0, 21200.0]))]
+    /// Max efforts in N. Must contains the same number of elements as `speeds`.
     max_efforts: Vec<f64>,
 }
 

editoast/openapi.yaml

@@ -6413,6 +6413,7 @@ components:
           items:
             type: number
             format: double
+          description: Max efforts in N. Must contains the same number of elements as `speeds`.
           example:
           - 23500.0
           - 23200.0
@@ -6423,6 +6424,7 @@ components:
           items:
             type: number
             format: double
+          description: Speeds in m/s. Must contains the same number of elements as `max_efforts`
           example:
           - 0.0
           - 2.958

front/src/common/api/generatedEditoastApi.ts

@@ -3072,7 +3072,9 @@ export type EffortCurveConditions = {
   power_restriction_code: string | null;
 };
 export type EffortCurve = {
+  /** Max efforts in N. Must contains the same number of elements as `speeds`. */
   max_efforts: number[];
+  /** Speeds in m/s. Must contains the same number of elements as `max_efforts` */
   speeds: number[];
 };
 export type ConditionalEffortCurve = {