Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Language guidance #653

Open
nickrbb opened this issue Sep 20, 2023 · 1 comment
Open

Language guidance #653

nickrbb opened this issue Sep 20, 2023 · 1 comment
Labels
Status:New An issue/PR that not yet have been discussed/announced at a VSS meeting

Comments

@nickrbb
Copy link
Contributor

nickrbb commented Sep 20, 2023

There is a lack of written guidance regarding language to be used in VSS. We currently implicitly use the English language, with a preference for using American terminology for parts of the vehicle e.g. trunk instead of boot, tire instead of tyre, etc. It would be advantageous, particularly those new to contributing, to formalise these current implicit rules by agreeing and documenting them.

It is suggested to reference out to ISO language guidance (see sections 7-9 at https://www.iso.org/sites/directives/current/part2/index.xhtml), which then aligns VSS with mature and already well understood guidelines by those in the automotive industry, but note any exceptions and further clarifications e.g. American terminology for vehicles is used, decimal point is a dot rather than a comma. This could probably be done in a new section at https://covesa.github.io/vehicle_signal_specification/rule_set/basics/.

If agreed in principal, I can prepare a written proposal.

@erikbosch
Copy link
Collaborator

There is a small note in https://github.com/COVESA/vehicle_signal_specification/blob/master/CONTRIBUTING.md#use-existing-style that American English is preferred, but having it in the general documentation as well makes sense. From my perspective a Pull Request from your side would be appreciated.

@erikbosch erikbosch added the Status:New An issue/PR that not yet have been discussed/announced at a VSS meeting label Sep 20, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Status:New An issue/PR that not yet have been discussed/announced at a VSS meeting
Projects
None yet
Development

No branches or pull requests

2 participants