Tags: Reference-Guide
- Accessibility Checklist for User Documentation
This checklist supports documentation teams in ensuring that userfacing content is accessible to all users, including those using assistive technologies. It can be applied during content creation, review, and prepublication.
- Architecture Review Guideline
Architecture Review Goals
- Area and Iteration Path
"Area Path" and "Iteration Path" are standard fields in Azure DevOps (ADO), and they are used to organize work items by product classification, team, and time period.
- Attack Surface Analysis
Performing an Attack Surface Analysis includes analyzing the security architecture to identify and document product interfaces and surfaces that could be attacked, as well as consider if there are planned security measures that will provide enough protection against attacks on these surfaces.
- Code Review Guideline
A code review intends to improve the quality of the code. Someone other than the author of the code performs the examination. Code review is mandatory for new code and code changes (pull request).
- Code Signing
Code signing is a crucial process in software development that ensures the integrity and authenticity of software code. It involves applying a digital signature to software programs, scripts, or drivers.
- Color Guide for Azure DevOps
Recommendations of colors for dashboards and graphs in Azure DevOps.
- Compliance Checklist for User Documentation
This checklist ensures that user documentation adheres to relevant regulatory, legal, and organizational standards. It is particularly important for regulated industries (e.g. medical, automotive, and industrial IoT) or when documentation is published publicly.
- Cyber Security Assessment
All ABB products or system offerings which are softwarerelated need to fulfill some mandatory cyber security requirements as described in the CFSCP02 Information & Cyber Security Policy.
- Cyber Security Course Path
This guide gives an overview of the suggested course path for education about the cyber security lifecycle for teams that work with ABB products, systems, or solution offerings that are software related.
- Cyber Security In User Documentation
User documentation should provide the necessary information to help the customer ensure that the site is as secure as possible.
- Definition of Ready and Definition of Done
The "Definition of Ready" (DoR) are the checks performed when a system epic, epic, feature, story, or bug is defined and ready to start work on. The "Definition of Done" (DoD) is the checks performed when the work items are completed before it is closed.
- Documentation Review Checklist
Use this checklist to ensure user documentation is clear, consistent, accurate, compliant, accessible, ready for localization, properly reviewed, and finalized.
- DoD for L4 Bugs
The definition of done (DoD) for L4 bugs are the checks performed when an L4 bug is considered completed.
- Fault Tracing Outside PCP Using a Debug Release
During L4 fault tracing it may be required to send a debug release outside of PCP. This has to be handled with care as it isn't a formally released software.
- Functional Description and Detailed Design Guideline
This guideline describes how to write Functional Description and Detailed Design documents.
- Functional Description and Detailed Design Review Guideline
This guideline describes how to perform a Functional Description and Detailed Design review.
- How-to Manage Dashboards Automatically
Dashboard creation can be repetitive and time consuming. This guide describes how to manage dashboards automatically.
- How-to Manage Queries Automatically
Query creation can be repetitive and time consuming. This guide describes how to manage queries automatically.
- New Product Introduction (NPI)
Hardware products are manufactured by Electronic Manufacturing Services (EMS). The EMS is responsible for assembling the product according to ABB design. This page describes key items in the New Product Introduction (NPI).
- Product Lifecycle Management in Windchill
A Product lifecycle management (PLM) system enables collaboration between different functions by gathering all productrelevant data in one place. For hardware development, the choice is in Windchill. This page intends to be a goto page for how to find information regarding Windchill.
- Pull Request Reference
What is a pull request?
- R&D Quality Criteria
The "R&D Quality Criteria" is a tool and checklist for Quality Control Managers (QCM), and is used to plan quality audits and assessments for project milestones and report quality status.
- Recommended Component Test Frameworks
The following component test frameworks are recommended but not mandatory.
- Recommended Unit Test Frameworks
The following unit test frameworks are recommended but not mandatory.
- Reference: Considerations to make in PCB layout
This page is intended to be a base for the creation of a new PCB layout. It is meant to be supported together with the PCB layout checklist, which is to be used in the development of the layout.
- Reference: Engineering Service Request (ESR) vs Engineering Change Order (ECO)
The engineering service request is the main template to be used during development. The purpose of this site is to reference the two different options when communicating with a Service Provider (for instance layout work, parts list, etc.).
- Reference: Handling of HW maintenance
Hardware development has a lot of interactions with internal ABB functions and external suppliers, manufacturers, and customers. This page is intended to give an overview of how maintenance tasks come to the R&D Hardware teams.
- Reference: High-speed design formulas
All relevant formulas which are necessary for highspeed design analysis are listed on this page.
- Reference: Structure of Combitrol & Combimatic documentation
This page is intended to give an overview of what kind of documentation is present for the Combitrol & Combimatic documentation.
- Reference: What does the Production Package contain?
A production package is created for every product and is the basis for a manufacturer. A production site is commonly called an electronic manufacturing service (EMS). This list is used by the EMS to create the product (box build).
- Scope Definition Checklist
The developer/author scope definition quick checklist.
- Secure Coding Guideline
Secure coding standards are guidelines, best practices, and coding conventions that can be used by software developers to prevent security vulnerabilities and improve the overall quality of the software during the software design & development phases.
- Secure Coding Guideline, .NET
This document describes the secure coding guidelines for the .NET programming language. Some of the guidelines are generic, whereas some are specific to the .NET programming language.
- Secure Coding Guideline, C
This document describes the secure coding guidelines for the C programming language. Some of the guidelines are generic, whereas some of them are specific to the C programming language.
- Secure Coding Guideline, ReactJS
This document describes the secure coding guidelines for ReactJS. Some of the guidelines are generic, whereas others are specific to ReactJS.
- Security Criticality Analysis
The Security Criticality Analysis is performed to identify which of the components in a product are important to pay extra attention to when trying to minimize the risk of vulnerabilities.
- Security Testing Guideline
Introduction
- Standard Bug Templates
This guideline describes the custom standard fields used in bug templates. For a more general picture of the standard work item template change process in Azure DevOps, see ADO standard work item template change management process.
- Standard Document Update Template
This guideline describes the Document Update work item type and the custom standard fields used in its template. For a more general picture of the standard work item template change process in Azure DevOps, see ADO standard work item template change management process.
- Standard Epic Template
This guideline describes the custom standard fields used in the Epic template. For a more general picture of the standard work item template change process in Azure DevOps, see the ADO standard work item template change management process.
- Standard Feature Template
This guideline describes the custom standard fields used in the Feature template. For a more general picture of the standard work item template change process in Azure DevOps, see the ADO standard work item template change management process.
- Standard System Epic Template
This guideline describes the fields used in the system epic template.
- Standard Test Case Template
This guideline describes the custom standard fields used in the Test Case template. For a more general picture of the standard work item template change process in Azure DevOps, see ADO standard work item template change management process.
- Standard User Story Template
This guideline describes the custom standard fields used in the User Story template. For a more general picture of the standard work item template change process in Azure DevOps, see ADO standard work item template change management process.
- System Requirement Review Guideline
A system requirement review intends to improve the quality of the requirements. It applies both to system requirements and technology requirements.
- System Test Entry-Exit Criteria
EntryExit criteria is a set of conditions that permits a task to perform, or in absence of any of these conditions, the task cannot be performed. Entry Criteria give the prerequisite items that must be completed before testing can begin in the respective phase. Exit Criteria define the items that must be completed before testing can be concluded in the respective phase.
- Test Case Checklist
Test case audit checklist.
- Test Phase Checklist
The test phase checklist is a general guide for users to gauge the quality of product build delivery before starting tests in system test (ST) or RAT. Further, tailoring can be done to align the checklist with any specific product.