Not because there is disagreement but more because I think people are too afraid of reprimand if they try to expand and discuss the information required.
That is true for myself as well. Over the last years, the atmosphere between teams has become very toxic for some reason.
I guess working in a team (let alone across teams) is very difficult for people used to working in isolation.
For example, you appeared to prefer XRayhTec's Python specification over my generic specification. Okay, so be it.
I have to revisit that, as I don't have either clear anymore.
We need two things to progress:
- The specification of the interface itself
This defines how the solution looks like from the point of the calling C, Python and Shell code.
Things like what do we call the beast, and how does it look from the ourside (list of values, public functions, a singleton class, etc). This has to be language specific, otherwise it can never be implemented.
- The specification of the individual items (may it be text strings in a file, global variables, functions or class methods)
I don't think my point 6 clashes with your template proposal (the fact it isn't there is undoubtedly related to your first remark).
Say for sake of argument we decide to go for a Python interface and implementation, and allow it to be callable from C or Shell, and we have the specification, a code template can be made without much issue.
As I am an avid proponent of documentation in code, the specification could easily be comments/docs, which would reduce the work, only one place for updates.
This will provide a class definition, factory code to access it, and method definitions with documentation. But no actual implementation.
This is where my point 6 comes in: given the vastly different ways in which teams create images, I don't want to force all teams into a single implementation, because that is doomed from the start, because of those differences.
This is no problem because the specification tells you how to call a method, which arguments to use, and what result to expect. How that result is obtained is not relevant, as long as it doesn't violate the specs.
Currently in use: VU+ Duo 4K (2xFBC S2), VU+ Solo 4K (1xFBC S2), uClan Usytm 4K Ultimate (S2+T2), Octagon SF8008 (S2+T2), Zgemma H9.2H (S2+T2)
Due to my bad health, I will not be very active at times and may be slow to respond. I will not read the forum or PM on a regular basis.
Many answers to your question can be found in our new and improved wiki.