Added get_bmi_version to sidl and documentation

[RolfHut]

solves #8

@mcflugen and I added get_bmi_version to the sidl and the documentation, but it still needs to be added to the different repos of the language specific bindings.

[mdpiper]

I'd like to touch the docs submitted with this PR, but otherwise it could be merged with lazy consensus.

[mdpiper]

The new get_bmi_version function is listed separately in the SIDL file, but under the model information functions in the docs. I'd like to propose modifying the SIDL file, moving the function def to match the docs like so:

    // Model information functions
    int get_component_name(out string name);
    int get_bmi_version(out string version);
    int get_input_item_count(out int count);
    ...

What do you think?

[RolfHut]

I'm ambivalent. @mcflugen and me had a short discussion on it: the thinking was (iirc) that the bmi_version does not say anything about the model, only on the implementation of bmi and that this could cause confusion. Will you update PR for this, or should I?

[mdpiper]

I'm ambivalent. @mcflugen and me had a short discussion on it: the thinking was (iirc) that the bmi_version does not say anything about the model, only on the implementation of bmi and that this could cause confusion. Will you update PR for this, or should I?

Ah, I see; that makes sense. If you'd prefer, I could invert my suggestion above and make a new section in the docs. I'd just like the docs to mirror the SIDL, and vice versa.

If you give me permissions to write to RolfHut:rolfhut/addBMIVersion, I can make changes.

[mdpiper]

@mcflugen What do you think--match the docs to the SIDL?

[mdpiper]

I moved the new get_bmi_version function to a new section in the docs, so it matches the ordering in the SIDL.

[RolfHut]

all ok with me