Update review guide authored by Nils Weiher's avatar Nils Weiher
......@@ -3,19 +3,38 @@ This guide describes the review/assessment workflow as part of the community bas
The guide is directed at reviewers that support the assessment through verifying the hardware's reproducability.
# The assessment workflow
The assessment workflow is the center of the community based assessment, which will check and - if applicable - approve that a piece of hardware can be studied, modified, produced and sold according to the definition by the [DIN SPEC 3105](/cab/docs/-/wikis/3-Further-Information/DIN-SPEC-3105). In short this means, the technology is reproducable without requirement of reverse engineering.
## Overview
The assessment can be performed as review, rebuild or remanufacture. For the attestation according to [DIN SPEC 3105](/cab/docs/-/wikis/3-Further-Information/DIN-SPEC-3105) the theoretical review is sufficient, which approves the proper quality of the documentation according to the definition.
However, for most technologies a rebuild would be required to actually verify the functionality (e.g. flashing a firmware on a PCB board). The Technology specific Documentation Criteria ([TsDC](/3-Further-Information/TsDC) should outline details on the requirements to proper assess single technologies.
By the OSEGeV definiton
- a review is the theoretical verification performed by a professional (or equivalent skilled) person that can approve the reproducability of the technology with the given information
- a rebuild is the practical verification of the basic funcionalities. It involves the assembly of components using a construction kit or similar (if available) and the setup (e.g. flashing firmware, installing software, basic configuration)
- a remanufacture is the reproduction of the technology from the scratch, so everything but standard or purchase parts is self-manufactured. One question behind remufacturing is, if the technology is scalable for industrial use.
## OSEGeV workflow
In the OSEGeV CAB the assessment is organised in corresponding issues on the GitLab instance.
----
in rework
---
# The assessment workflow
The assessment workflow is the center of the community based assessment, which will check and - if applicable - approve that a piece of hardware can be studied, modified, produced and sold according to the definition by the [DIN SPEC 3105](/cab/docs/-/wikis/3-Further-Information/DIN-SPEC-3105-Open-Source-Hardware). In short this means, the technology is reproducable without requirement of reverse engineering.
## Overview
Review happens in corresponding issues on the CAB's GitLab instance. They should be self-explanatory and may differ based on the projects structure. Usually we divide projects in different subgroups so you can go through the project step by step.
They should be self-explanatory and may differ based on the projects structure. Usually we divide projects in different subgroups so you can go through the project step by step.
Two Issues will always be there:
......
......