opendbc icon indicating copy to clipboard operation
opendbc copied to clipboard

doco/website: Add footnote to VW-group and Tesla cars to prevent user confusion about where harness connects (option 1 - brand-agnostic footnote)

Open borhub opened this issue 2 months ago • 0 comments

Follow-up from https://github.com/commaai/openpilot/pull/36325

The Comma website is missing information for VW car users informing them that the J533 harness doesn't connect to the usual location on the windshield camera as advertised on the Comma website. This omission caused users to be confused and their Comma installation delayed when the harness connector didn't match the camera connector which they expected to plug into. People think they got the wrong connector, have to go to Discord etc.

This change fixes the customer experience by adding a footnote that directs the users to connect to the correct module under the dash. The copy of the note is generic so that it can potentially be reused for other cars whose harness doesn't plug into the windshield camera, starting with Tesla already in this PR.


The generic, brand-agnostic copy solution option here has the benefit of not creating too many footnotes in CARS.md, but is slightly less specific which may lead to continued user confusion queries in brand-specific Discords. But perhaps a lot of footnotes in CARS.md is a non-issue (no-one reads that file?), and having more specific instructions about the harness location on the website is more important (that is what the alternative option PR https://github.com/commaai/opendbc/pull/2842 does).

Thoughts?

borhub avatar Oct 15 '25 10:10 borhub