documentation should be on a separate branch

[ashifolfi]

The docs pages should be hosted on a separate branch. so as to not pollute the main code.
this also means we should manually write documentation for code files to not pollute main code with xml docs anymore.