...
...
...
...
...
...
...
...
...
...
This development process aim to create workflow from open source development to product development for linux based instrument cluster. This process aim to be able to certify that it has quality control. This process must embrace by open source community and industry.
Attention: This rule applies to Instrument cluster software stack only.
1. Roadmap and Feature Planning
...
- T2.1-1 Create/update diagram and description of software component from use case point of view
- Use case diagram and/or Use case description should be showed in design documents to help understand requirements and to help have common understanding for requirements and,
- Use case diagram and/or Use case description show necessity of software component to be developed.
- T2.1-2 Create/update software component interface description
- This is important information for the component users, so it shall be included in design documents or described as markdown
- Developer shall define and describe meaning, parameter and return value of each interface
- If the order of calling interface function/method is important, we recommend that developer create a sequence diagram.
- T2.1-3 Create/update software component activity diagram
- T2.1-4 Create/update software component state machine diagram and table
- If the software component to be designed has a state, state transition should be represented by state machine diagram and/or state machine table.
- To prevent omission of consideration during design process, we recommend that developer checks his design using state machine table.
- T2.1-5 Create/update deployment diagram
- Developer should clarify related and/or interfering other components or hardware devices to show necessity of these.
- T2.1-6 Create/update software component test specification
- To Design test cases to meet the requirement coverage and
- To describe these as specification document.
Strong recommendation is to use UML for writing diagrams which are mentioned above.
See Architecture Design Template for the AGL development software for the document template.
...
- V2.1-2 Review the interface description
- The method of providing an interface should use for standard method of the own architectural layer.
Interface spec shall describe by standard format of the method.
ex. In case of C functional interface should be use doxygen. In case of REST interface should be use OpenAPI.- All review records must be written in AGL Jira.
...
- T3.2-1 Assessment for the change logs (release note, commit log , etc.)
- In initial phase, should update existing OSS frequently. In late phase and maintenance phase, should not update existing OSS frequently excluding to security fix and critical bug fix.
- Shall check to change log, because we need to judge "this change is need in this phase?".
- Create or update to the document of assessment results.
- T3.2-2 Source code check by static analysis tools
- Must check to source code using static analysis tool.
- When static analysis tool detected "Must Fix" error, that OSS must not use.
- When static analysis tool detected "Check by AGL" error, that OSS code must check and judge by AGL community before than adopting this OSS.
- When static analysis tool detected "Check by User" error, developer shall create error report only. AGL community provide risk information for that OSS to user.
- Checker rule as a follow:
- https://confluencelf-automotivelinux.automotivelinuxatlassian.orgnet/wiki/download/attachments/2696822917990946/clang_code_checker.xlsx?api=v2
- Must check to source code using static analysis tool.
- T3.2-3 Check for Software interface specification
- Check the source code and library software interface specifications provided by OSS.
- The important point is to check compatibility from previous version. When current phase is after M3-1, must not change to incompatible version.
- Create the document of check results or write in the release note.
...