Update docu

Author: ufechner7

docs/src/ram_air_kite.md

@@ -2,9 +2,15 @@
 CurrentModule = KiteModels
 ```
 ## Introduction
-The RamAirKite is based on ModelingToolkit, which allows to define the differential algebraic equations in symbolic form.
+The [`RamAirKite`](@ref) is based on ModelingToolkit, which allows to define the differential algebraic equations in symbolic form. It does not use a KCU. Instead, the kite is controlled from the ground (e.g. a ship) using three winches and four tethers.
 
-## Types
+## Private enumerations
+```@docs
+SegmentType
+DynamicsType
+```
+
+## Private types
 ```@docs
 Point
 Pulley
@@ -14,7 +20,7 @@ Winch
 KitePointGroup
 ```
 
-## Functions
+## Private functions
 ```@docs
 create_sys!
 diff_eqs!

src/ram_air_kite.jl

@@ -59,12 +59,33 @@ function Base.getproperty(m::Measurement, val::Symbol)
     end
 end
 
+"""
+    SegmentType `POWER` `STEERING` `BRIDLE`
+    
+Type of segment.
+
+# Elements
+- POWER: Belongs to a power line
+- STEERING: Belongs to a steering line
+- BRIDLE: Belongs to the bridle
+"""
 @enum SegmentType begin
     POWER
     STEERING
     BRIDLE
 end
 
+"""
+   DynamicsType `DYNAMIC` `STATIC` `KITE` `WINCH`
+
+Enumeration of the models that are attached to a point.
+
+# Elements
+- DYNAMIC: Belongs to a dynamic tether model
+- STATIC: Belongs to a static tether model
+- KITE: Rigid body
+- WINCH: Winch
+"""
 @enum DynamicsType begin
     DYNAMIC
     STATIC
@@ -73,7 +94,11 @@ end
 end
 
 """
-A normal freely moving tether point
+    mutable struct Point
+
+A normal freely moving tether point.
+
+$(TYPEDFIELDS)
 """
 mutable struct Point
     idx::Int16
@@ -86,7 +111,11 @@ function Point(idx, pos_b, type)
 end
 
 """
-Set of bridle lines that share the same twist angle and trailing edge angle
+    struct KitePointGroup
+
+Set of bridle lines that share the same twist angle and trailing edge angle.
+
+$(TYPEDFIELDS)
 """
 struct KitePointGroup
     idx::Int16
@@ -98,7 +127,11 @@ struct KitePointGroup
 end
 
 """
-A segment from one point index to another point index
+    mutable struct Segment
+
+A segment from one point index to another point index.
+
+$(TYPEDFIELDS)
 """
 mutable struct Segment
     idx::Int16
@@ -115,7 +148,11 @@ function Segment(idx, points, type, l0)
 end
 
 """
-A pulley described by two segments with the common point of the segments being the pulley
+    mutable struct Pulley
+
+A pulley described by two segments with the common point of the segments being the pulley.
+
+$(TYPEDFIELDS)
 """
 mutable struct Pulley
     idx::Int16
@@ -128,7 +165,11 @@ mutable struct Pulley
 end
 
 """
+    struct Tether
+
 A set of segments making a flexible tether. The winch point should only be part of one segment.
+
+$(TYPEDFIELDS)
 """
 struct Tether
     idx::Int16
@@ -137,7 +178,11 @@ struct Tether
 end
 
 """
-A set of tethers or just one tether connected to a winch
+    mutable struct Winch
+
+A set of tethers or just one tether connected to a winch.
+
+$(TYPEDFIELDS)
 """
 mutable struct Winch
     idx::Int16
@@ -180,7 +225,7 @@ struct PointMassSystem
 end
 
 """
-    mutable struct RamAirKite{S, T, P, Q, SP} <: AbstractKiteModel
+    mutable struct RamAirKite{S, V, P} <: AbstractKiteModel
 
 State of the kite power system, using a quaternion kite model and three steering lines to the ground. Parameters:
 - S: Scalar type, e.g. SimFloat