Add Documenter docu

Author: ufechner7

docs/Project.toml

@@ -0,0 +1,10 @@
+[deps]
+Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
+KiteUtils = "90980105-b163-44e5-ba9f-8b1c83bb0533"
+
+[compat]
+julia = "1.10, 1.11"
+KiteUtils = "0.7, 0.8, 0.9, 0.10"
+Documenter = "0.27"
+
+

docs/make.jl

@@ -0,0 +1,26 @@
+using WinchControllers
+using Documenter
+
+# DocMeta.setdocmeta!(WinchControllers, :DocTestSetup; recursive=true)
+
+makedocs(;
+    modules=[WinchControllers],
+    authors="Uwe Fechner <[email protected]>",
+    repo="https://github.com/aenarete/KiteModels.jl/blob/{commit}{path}#{line}",
+    sitename="WinchControllers.jl",
+    format=Documenter.HTML(;
+        prettyurls=get(ENV, "CI", "false") == "true",
+        canonical="https://aenarete.github.io/WinchControllers.jl",
+        assets=String[],
+    ),
+    pages=[
+        "Home" => "index.md",
+        "Types" => "types.md",
+        "Functions" => "functions.md"
+    ],
+)
+
+deploydocs(;
+    repo="github.com/aenarete/WinchControllers.jl",
+    devbranch="main",
+)

docs/src/functions.md

@@ -0,0 +1,21 @@
+```@meta
+CurrentModule = WinchControllers
+```
+## Input functions
+```@docs
+set_vset_pc
+```
+
+## Output functions
+```@docs
+calc_output
+calc_vro
+get_state
+```
+
+## Utility functions
+```@docs
+@limit
+saturate
+merge_angles
+```

docs/src/index.md

@@ -0,0 +1,42 @@
+```@meta
+CurrentModule = WinchControllers
+```
+
+# WinchControllers
+Documentation for the package [WinchControllers](https://github.com/aenarete/WinchControllers.jl).
+
+This package is part of Julia Kite Power Tools, which consist of the following packages:
+
+![Julia Kite Power Tools](kite_power_tools.png)
+
+## Installation
+Install [Julia 1.10](https://ufechner7.github.io/2024/08/09/installing-julia-with-juliaup.html) or later, if you haven't already. On Linux, make sure that Python3 and Matplotlib are installed:
+```
+sudo apt install python3-matplotlib
+```
+Before installing this software it is suggested to create a new project, for example like this:
+```bash
+mkdir test
+cd test
+julia --project="."
+```
+Then add WinchControllers from  Julia's package manager, by typing:
+```julia
+using Pkg
+pkg"add WinchControllers"
+``` 
+at the Julia prompt. You can run the unit tests with the command (careful, can take 60 min):
+```julia
+pkg"test WinchControllers"
+```
+
+## Provides
+
+## See also
+- [Research Fechner](https://research.tudelft.nl/en/publications/?search=Fechner+wind&pageSize=50&ordering=rating&descending=true) for the scientic background of this code
+- The meta-package  [KiteSimulators](https://github.com/aenarete/KiteSimulators.jl)
+- the package [KiteUtils](https://github.com/ufechner7/KiteUtils.jl)
+- the packages [WinchModels](https://github.com/aenarete/WinchModels.jl) and [KitePodModels](https://github.com/aenarete/KitePodModels.jl) and [AtmosphericModels](https://github.com/aenarete/AtmosphericModels.jl)
+- the packages [KiteControllers](https://github.com/aenarete/KiteControllers.jl) and [KiteViewers](https://github.com/aenarete/KiteViewers.jl)
+
+Author: Uwe Fechner ([email protected])

docs/src/kite_power_tools.png

@@ -0,0 +1,10 @@
+# Exported Types
+
+```@meta
+CurrentModule = WinchControllers
+```
+
+## Basic types
+```@docs
+WCSettings
+```

docs/src/types.md

@@ -0,0 +1,24 @@
+# build and display the html documentation locally
+# you must have installed the package LiveServer in your global environment
+
+using Pkg
+
+function globaldependencies()
+    projectpath = Pkg.project().path
+    basepath, _ = splitdir(projectpath)
+    Pkg.activate()
+    globaldependencies = keys(Pkg.project().dependencies)
+    Pkg.activate(basepath)
+    globaldependencies
+end
+
+if !("LiveServer" in globaldependencies())
+    println("Installing LiveServer globally!")
+    run(`julia -e 'using Pkg; Pkg.add("LiveServer")'`)
+end
+
+if !("Documenter" ∈ keys(Pkg.project().dependencies))
+    using TestEnv
+    TestEnv.activate()
+end
+using LiveServer; servedocs(launch_browser=true)