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

Doc Update #788

Merged
merged 2 commits into from
Nov 12, 2024
Merged

Doc Update #788

merged 2 commits into from
Nov 12, 2024

Conversation

erikbosch
Copy link
Collaborator

@erikbosch erikbosch commented Nov 1, 2024

This PR contain various documentation updates, the significant being:

  • Changed to table for showing possible branch/entry attributes, and added some not missing
  • Added the newly proposed pattern attribute
  • Changed description on default for structs, so it is clear that it is allowed and including a few examples

For a live version visit https://erikbosch.github.io/vehicle_signal_specification/

Signed-off-by: Erik Jaegervall <[email protected]>
`min` | The minimum value, within the interval of the given `datatype`, that the data entry can be assigned. If omitted, the minimum value will be the "Min" value for the given datatype. Cannot be specified if `allowed` is defined for the same data entry.
`max` | The maximum value, within the interval of the given `datatype`, that the data entry can be assigned. If omitted, the maximum value will be the "Max" value for the given datatype. Cannot be specified if `allowed` is defined for the same data entry.
`unit` | The unit of measurement that the data entry has. See [Data Units](/vehicle_signal_specification/rule_set/data_entry/data_units/) chapter for a list of available units. Cannot be specified if `allowed` is defined for the same data entry.
`pattern` | Can be used for datatype `string` to specify a regular expression that limits allowed values for the data entry. The expression must be supported by [Python Regular Expressions](https://docs.python.org/3/howto/regex.html) | *since version 6.0*
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would it worth if we say that patterns can be used for string and string[] or it can be assumed that after one type is allowed, then its plural (array) version is also allowed?

Other than this, I checked the online test link, you provided: https://erikbosch.github.io/vehicle_signal_specification/rule_set/data_entry/sensor_actuator/index.html and this part is OK for me.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Makes sense to mention also [], will update

Signed-off-by: Erik Jaegervall <[email protected]>
@erikbosch
Copy link
Collaborator Author

MoM:

  • Erik presented changes, including part of backward incompatibility and datatypes
  • Please review

@erikbosch
Copy link
Collaborator Author

MoM: Ok to merge

Copy link
Contributor

@Kostadin-Ivanov Kostadin-Ivanov left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me.

@erikbosch erikbosch merged commit 3498ede into COVESA:master Nov 12, 2024
5 checks passed
@erikbosch erikbosch deleted the erik_doc branch November 12, 2024 15:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants