Render API documentation of Python bindings on website

[uekerman]

The Python bindings are one of the most important ways how users work with preCICE. We spent quite some time to write nice docstrings for the bindings. I would be good if we could integrate this documentation on the website as well. Ideally in such a way that also our search engine sees them.

Maybe a solution could be to first convert them into markdown (maybe via docutils or sphinx, I did not do much research yet) and then include in Jekyll.

Alternatively, we also directly generate html via sphinx, but this is probably not what we want.

[MakisH]

Would be a solution for #165

[MakisH]

Discussion:

• We should do this before somebody else does it
• We could use Sphinx
• We could even use Doxygen
• We could even manually convert it to Markdown and put it on the website (not ideal)
• Important in any case would be to clearly link to the actual website
• We could also link the "couple your code" for examples.
• We don't want to make the "noise" searchable, just the API. See Include doxygen Participant page into search index #395.