Documentation of supported bindings

[jbcoe]

List what is intended to work and what is intended to not work.

[petr-tik]

As part of documenting the API etc, I suggest we agree on a doc generator tool that we can use across different languages. I will then go through functions and document them in terms of input and output.

This should provide us with a good skeleton, which we can expand with system docs

http://www.sphinx-doc.org/en/stable/ https://github.com/doxygen/doxygen

Thoughts?

[jbcoe]

The docs I had in mind are more along the lines of tests:

GIVEN this input WHEN I run FFIG.py THEN I get this cppmodel and these python bindings etc.

I'm not sure that can be generated.

[petr-tik]

Ok, but as a separate issue, is it ok if I go through the codebase adding docstrings to python methods and classes?

[jbcoe]

Please do! That would be really helpful.