Martin Lueders requested to merge documentation/states into main Aug 18, 2023

Description

add more doxygen for states

News snippet

add more doxygen for states

Checklist

I have checked that my code follows the Octopus coding standards
I have added tests for all the new features added in this request.