WIP: Documentation Improvements, DO NOT MERGE

Hey Seth,

can you have a look at my current WIP of the documentation improvements.

I tried to add as much information as possible.

I am not sure if I understood everything correctly, so please review :)

I still have to figure out how the "scheduleAgents" stuff works. I am not even sure if it is.

Please DO NOT MERGE, because I am still working on it.

Thanks and kind regards
Markus¹