dasharo certification program: initial commit

docs/certification/overview.md

@@ -0,0 +1,86 @@
+# Dasharo Certification Program
+
+Our commitment to long-term maintenance and transparent validation lead us to
+creation of Dasharo Certification Program. We would like to recognize that
+without strict project management, hardware integration and validation
+procedures maintaining significant number of hardware targets would be
+impossible.
+
+More to that to maintain open-source firmware for multiple hardware targets we
+have expect certain quality from code
+
+Dasharo Certification Program consist of three main parts:
+
+* Dasharo Onboarding with Silicon Vendor
+* Project Infrastructure Setup for Dasharo Certification Program
+* Lab Setup for Dasharo Certification Program
+
+Dasharo Certificate consists of test procedures, test results report, and test
+logs confirming compliance with Program scope. All results of public Dasharo
+Certification Program will be accessible publicly.
+
+* [Dasharo Universe](https://docs.dasharo.com)
+* [Dasharo Github](https://github.com/Dasharo)
+
+Obviously not all our customers wish to publish Dasharo Certification results.
+We respect will of our customers to not make Dasharo Certificaiton public.
+
+## Goals
+
+We hope that Dasharo Certification Program will lead to:
+
+* establishing certain standard for quality of open-source firmware distributions
+* better understand of real cost of open-source firmware maintenance
+* increase number of certified hardware platforms by bringing already
+  platforms which are already ported to open-source firmware, but there are no
+  quality control during the release process
+
+## Dasharo Onboarding with Silicon Vendor
+
+Critical part of creating any open-source firmware port since without
+documentation any development have to rely on gaining adversarial
+interoperability, what may be resource-intensive or in some cases even
+impossible. Over the years we realize how to correctly onboard project and
+build mutual relation between customers, Silicon Vendor and us. As a result we
+included Dasharo Onboarding with Silicon Vendor in Dasharo Certification
+Program and make it mendatory part.
+
+There are rare exceptions from onboarding, but it always have to be decided
+individually with customer.
+
+## Project Infrastructure Setup for Dasharo Certification Program
+
+Project Infrastructure Setup is first step of Dasharo Certification Program, it
+consist of structural approach to following activities:
+
+* formal Software Provider's resource allocation including legal, logistics and
+  financial fees,
+* program kick-off,
+* program execution plan monitoring, coordination and communication,
+* Dasharo Certification release quality control.
+
+## Lab Setup for Dasharo Certification Program
+
+Every Dasharo Certification candidate have to be integrated in Dasharo
+Certification Laboratory. Correct integration means:
+* detailed analysis of Client's Infrastructure schematics and documentation,
+* setup of remote and automated environment for development, debugging and testing,
+* Client's Infrastructure preparation for manual testing procedures, if not all
+  tests can be automated,
+* provisioning and configuration of Dasharo Transparent Validation system that
+  will execute test required for Dasharo Certification Program,
+
+<!--
+## Limitations
+
+Dasharo is registered trademark of 3mdeb Sp. z o.o. Poland-based limited
+liability company. Only OEMs and communities, which obtained Dasharo
+Certification are allowed to use Dasharo logo for open-source firmware
+promotion.
+-->
+
+## Naming conventions
+
+Dasharo programs are called after microarchitectures supported as part of given
+program e.g. Dasharo Intel Alder Lake P Certification Program for MSI PRO
+Z790-A DDR5.

mkdocs.yml

@@ -24,8 +24,8 @@ markdown_extensions:
 nav:
   - 'Intro': index.md
   - 'Supported hardware':
-      # - 'Hardware Compatibility List': variants/hardware-compatibility-list.md
-      - 'Dell OptiPlex':
+  #   - 'Hardware Compatibility List': variants/hardware-compatibility-list.md
+      - 'Dell OptiPlex 9010':
           - 'Overview': variants/dell_optiplex/overview.md
           - 'Releases': variants/dell_optiplex/releases.md
           - 'Building manual': variants/dell_optiplex/building-manual.md
@@ -58,7 +58,7 @@ nav:
           - 'Hardware configuration matrix': variants/talos_2/hardware-matrix.md
           - 'Test matrix': variants/talos_2/test-matrix.md
           - 'Conference materials': variants/talos_2/conferences.md
-    #   - 'NovaCustom NV4x 11th gen':
+      #   - 'NovaCustom NV4x 11th gen':
       - 'NovaCustom NV4x':
           - 'Overview': variants/novacustom_nv4x/overview.md
           - 'Releases': variants/novacustom_nv4x/releases.md
@@ -181,29 +181,32 @@ nav:
       - 'Trusted Computing': osf-trolling-list/trusted_computing.md
       - 'Jira Service Management': osf-trolling-list/jsm_documentation.md
       - 'Intel ME/CSME': osf-trivia-list/me.md
-  - 'Ecosystem':
-      - 'Overview': ecosystem/overview.md
-    # - 'Customer Infrastructure': ecosystem/customer-infrastructure.md
-      - 'Transparent Validation':
-        # - 'Overview': ecosystem/transparent-validation.md
-        # - 'Testing Infrastructure': ecosystem/testing-infrastructure.md
-        # - 'Hardware Laboratory': ecosystem/hardware-infrastructure.md
-          - 'MSI Z690':
-              - 'Assembly and Validation': transparent-validation/msi-z690/assembly-and-validation.md
+  - 'Dasharo Certification Program':
+      - 'Overview': certification/overview.md
+      - 'Hardware tools':
           - 'muxPi':
               - 'Theory of Operations': transparent-validation/muxpi/theory-of-operations.md
               - 'Basic validation': transparent-validation/muxpi/basic-validation.md
           - 'Remote Testing Environment':
               - 'Introduction': transparent-validation/rte/introduction.md
               - 'Specification': transparent-validation/rte/v1.1.0/specification.md
               - 'Getting Started': transparent-validation/rte/v1.1.0/getting-started.md
-        #     - 'RTE and PC Engines': transparent-validation/rte/pcengines.md
               - 'RTE Reference OS': transparent-validation/rte/v1.1.0/reference-os.md
               - 'Revision History': transparent-validation/rte/revision-history.md
           - 'SD Wire':
               - 'Getting started': transparent-validation/sd-wire/getting-started.md
               - 'Specification': transparent-validation/sd-wire/specification.md
               - 'Usage': transparent-validation/sd-wire/usage-validation.md
+      - 'Lab Assembly Guides':
+          - 'Overview': certification/lab-overview.md
+      #   - 'Dell OptiPlex 9010': transparent-validation/dell_optiplex/assembly-and-validation.md
+          - 'MSI PRO Z690-A WIFI DDR4': transparent-validation/msi-z690/assembly-and-validation.md
+  - 'Ecosystem':
+      - 'Overview': ecosystem/overview.md
+    # - 'Customer Infrastructure': ecosystem/customer-infrastructure.md
+        # - 'Overview': ecosystem/transparent-validation.md
+        # - 'Testing Infrastructure': ecosystem/testing-infrastructure.md
+        # - 'Hardware Laboratory': ecosystem/hardware-infrastructure.md
     # - 'Secure Storage': ecosystem/secure-storage.md
     # - 'Signing Server': ecosystem/signing-server.md
     # - 'Attestation Server': ecosystem/attestation-server.md