docs: update to include new directives

[deviantfero]

I figured we might need this, I don't particularly like the way it looks though, maybe some adjustments can be made?

[skanaar]

Great! Yes, this documentation could use some move love. But this is good enough for the moment, I will be away on vacation for a few weeks now. ⛵️🍹