Reported by michelpons, 4 years ago.

On the main page on the COBIA Reference, the section "About this document" states both what is the document and what it is not: "This document is not intended to be a development guide." What have we as a development guide? A document was developed for the COBIA training course given in October 2018. Rather than being completely negative about a development guide, would it be better to let the reader request the training material if felt necessary. The availability of this training material to individuals/organizations outside of CO-LaN is not decided yet but at least something exists that can be requested, at least by CO-LaN members.

Reported by michelpons, 4 years ago.

When I propose text about "what is COBIA", I re-used text that we had put together previously. When re-reading it, I am not sure that " and to support a variety of development tools" is the proper language. Looking at what is meant by "development tools", I find "A computer program that is used by the software developers for creating, editing, maintaining, supporting and debugging other applications, frameworks and programs – is termed as a Software Development Tool or a Software Programming Tool. Development tools can be of many forms like linkers, compilers, code editors, GUI designer, assemblers, debugger, performance analysis tools etc.". Are we meaning really all these or are we stating that COBIA is meant to support a number of programming languages? It may not even be "support" but "bind automatically to several programming languages". What is the meaning given to "development tools" in our text?

Reported by michelpons, 4 years ago.

In the section on interfaces, wrappers and adapters of the main page of the COBIA Reference, at the very end, there is the following sentence "To generate all the functions and derive from the proper base class to implement an interface, the COBIA code generators can be used. E.g. use COBIA_CodeGen with the -c, -i and -A options." The code generator is not part of the reference. Is there a way to point to some place on the machine where the code generator stands? The COBIA SDK installer does not give the option to install only COBIA Reference so everything present in the COBIA SDK installer ends up to be installed, among those the COBIA code generator. So is there a link somehow that can be inserted to point to the code generator executable? Otherwise this reference does not make much sense as it is.