> I was just looking at a small open source utility. As I was going through the code I found cases where certain arguments could be set to magic values that cause useful, but undocumented behavior. Should the developers be forced to document these options?
You were able to do that because it was open source. If a car mfr was willing to do that, it would be plenty enough for me. They shouldn't be forced to do any additional work beyond the 5 seconds it takes to type `git remote add origin github.com/honda/civic`. Then the community would have everything it needs to carry things forward.
Failing that, yes, I do think everything should be documented.
GP's point was not that manufacturers must use github - that was an arbitrary "for instance". They saying if the mfg is not going to open source their software, then they should be required to document it.
Certain PID values are bit-packed in non-obvious ways (like the tens digit is in one byte, ones in another, decimal in another) and units of measure are 'known' but might not be obvious. Publishing that information (which already exists! How do you think they write software?) would be a nice step in the right direction
There are a ton of dbc files floating around like this. Almost any car with a turbo has a kit to flash the ecu for more boost, so even the proprietary signals have been reversed.
You were able to do that because it was open source. If a car mfr was willing to do that, it would be plenty enough for me. They shouldn't be forced to do any additional work beyond the 5 seconds it takes to type `git remote add origin github.com/honda/civic`. Then the community would have everything it needs to carry things forward.
Failing that, yes, I do think everything should be documented.