-
Notifications
You must be signed in to change notification settings - Fork 14
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
impl: proposal for coding guidelines #647
base: main
Are you sure you want to change the base?
Conversation
hoe-jo
commented
Mar 12, 2025
- Coding Guidelines
- Code Analysis
- Coding Guidelines - Code Analysis - MISRA mapping
License Check Results🚀 The license check preparation job ran successfully. Status: Click to expand output
|
The created documentation from the pull request is available at: docu-html |
Coverage | ||
======== | ||
|
||
As required by the verification guideline coverage needs to be calculated for the code which is used in the project. For a release the coverage needs to be calculated on the target (QNX). However for development also a quicker approach on the host shall be available. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I don't understand why QNX is mentioned in here.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
QNX is not target meant in ISO26262, we need here reference HW coverage
|
||
Following sections provide a short overview of the most important features of each applied tool: | ||
|
||
Memcheck |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
back in the day I was using Valgrind
- of which Memcheck is part of. It supports additional tools for dynamic checks.
.. | ||
.. csv-table:: MISRA C++:2023 Rule Mapping | ||
:name: misra_2023_rule_mapping | ||
:file: _assets/misra_2023.csv |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
is the file missing, I saw that you added *csv in the docs/BUILD
?
Maybe you forgot to stash it?
|
||
Code Formatter | ||
============== | ||
Appropriate code formatting provides a source code which is easier to read and better to understand as it follows a well defined, known standard. That is why usually code formatters are applied. For this project *Clang-Format* shall be used. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
shall be used is normative formulation, would expect that either as process requirement or in another decision document, there are more shalls in this document
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
For showing in the audit, it is ok for me, but I would this document in the future not under process
coverage --> gtest | ||
gtest --> gcov | ||
gcov --> host | ||
gcov --> qnx |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
qnx -> reference HW