first attempt to document core

Sorry. I forgot the extension in the example. It should be ```[system agent documentation](doc/systemagent.md)```. Otherwise it will not work, at least on github.