Split docu in repos

[vkresch]

Reference to a related issue in the repository

This PR fulfills the requirement from here.

resolves #7

Add a description

This PR gets rid of the docu folders of each repo in the OSI organization. For now there is only a parsing of the docu from each cloned repo.

Mention a member

@pmai @jdsika pls review :)

Check the checklist

• I have performed a self-review of my own code/documentation.
• My documentation changes are related to every repo in the OSI organization.
• My changes generate no new warnings during the documentation generation.
• The existing travis ci which pushes the documentation to gh-pages passes with my changes.

[jdsika]

You can merge after quickly answering my questions here, please

[jdsika]

I do not understand this step here:

• you clone osi twice? does the osi-validation need the module itself. I thought it should be more something like:
  git clone osi
  cd osi
  make install

-> osi-validation is now able to find the package because it was installed?

[vkresch]

I make two clones of osi one in osi-documentation/open-simulation-interface and one in osi-documentation/osi-validation/open-simulation-interface. The first clone is used to parse the docu and the second one is used by osi-validation and to install osi. I could change the paths in index.rst to osi-validation/open-simulation-interface/doc/*.rst and get rid of the first cloning but I thought the paths open-simulation-interface/doc/*.rst are more consistent according to the other repos. I could be wrong. Maybe the multiple cloning is more confusing.

[vkresch]

for now osi-validation also needs the folder

[vkresch]

Here is how the docu will look like after merging. The READMEs are now the entry point of each topic like discussed.

[jdsika]

I do not understand this as well

[vkresch]

I exclude these folders so they don't get parsed by sphinx. Sphinx throws warning when it finds any *.md file which is not used.