Documentation

Checklist list

Checklist

Have you made your original design files publicly available?

Have you made your any auxiliary design files publicly available? (optional)

Have you made a bill of materials publicly available?

Have you made photos of your product at various stages of assembly publicly available? (optional)

Have you made any instructions or other explanations publicly available? (optional)

Have you properly licensed your design files so that others may reproduce or build upon them?

About

All OSHWA-certified hardware must provide “documentation including design files, and must allow modification and distribution of the design files” per the Open Source Hardware Definition. The more robust and explanatory this documentation is, the better. This is for two reasons:

  1. More robust documentation makes it easier for downstream users to build, use, and iterate on your product.
  2. Robust documentation, especially when paired with creative design elements and descriptive text, takes on greater amounts of copyright protectability to prevent against misuse.

Note that copyright-protected product documentation can still be open and easily usable by downstream users. Stronger copyright protection for product documentation merely makes it easier to attempt to enforce the terms of the applied copyright license.

To ensure that downstream users are free to use your documentation, all open source documentation is required to be licesed openly, such as with a Creative Commons (CC) license. Which CC license you choose is up to you: pick the one that most closely aligns with your desires for your project and follow the CC guide to sharing your work.

All written or drawn materials have some inherent copyright protection. The amount of protection copyright offers varies depending on whether the materials are purely functional or more creative and artistic.

It is important to note that copyright protection for documentation only means that other creators cannot copy your design documentation without your permission (which you grant them through the CC license). It does not stop other creators from making a physical object based on the instructions that the documentation provides or making their own version of your documentation.

Checklist list

Checklist

Have you made your original design files publicly available?

Have you made your any auxiliary design files publicly available? (optional)

Have you made a bill of materials publicly available?

Have you made photos of your product at various stages of assembly publicly available? (optional)

Have you made any instructions or other explanations publicly available? (optional)

Have you properly licensed your design files so that others may reproduce or build upon them?

Spectrum

Copyright-protected product documentation can still be open and easily usable by downstream users. Stronger copyright protection for product documentation merely makes it easier to attempt to enforce the terms of the applied copyright license. Creating thorough, robust, and creative documentation increases the enforceability of its license terms.

All of these products’ documentation are “open” documentation because they use a license to enable downstream users to copy and build upon them.

The spectrum below shows the range of protectability of various products. The schematics towards the left side of the spectrum are generally more stripped down and functional, lacking creative embellishments or illustrations. This makes them less protectable under copyright law. As you move across the spectrum, the schematics integrate an increasing number of non-functional, creative design elements, increasing their protectability.

Less
Protectable

More
Protectable

HackEEG schematic

This is the schematics for a microcontroller board that has been successfully used in major research institutions and pharmaceutical companies. The HackEEG schematic is almost purely functional, making it relatively less protectable against uses that violate the license applied to the documentation.

hackeeg-schematic

Handibot Model

Handibot is a smart power tool, digitally controlled and portable. It is a small 3D printable device that can machine plastic, wood, and aluminum.

The Handibot model is in the middle of the spectrum because it is largely functional, but the color choices and visual elements contain a degree of creativity.

model

Smoothieware Guide

Smoothieware makes a controller for digital fabrication machines, including laser cutters, 3D printers, and computer numeric control (CNC) mills.

The Smoothieware Guide is most protectable because it features both images and text that expresses a high degree of creative thought and artistic design.

smoothieware-guide
Checklist list

Checklist

Have you made your original design files publicly available?

Have you made your any auxiliary design files publicly available? (optional)

Have you made a bill of materials publicly available?

Have you made photos of your product at various stages of assembly publicly available? (optional)

Have you made any instructions or other explanations publicly available? (optional)

Have you properly licensed your design files so that others may reproduce or build upon them?

Licensing

In order to ensure downstream users are free and clear to use your documentation, all open source documentation is required to include an open copyright license. Which license you choose is up to you. We recommend using a Creative Commons license on your product documentation. Pick the one that most closely aligns with your desires for your project. Please visit the Creative Commons website for a full description and explanation of the different CC licenses and a guide to their use. Other open copyright licenses may be acceptable under the OSHWA definition. We recommend Creative Commons, however, due to its widespread acceptance, recognition, and ease of use.

Checklist

Have you made your original design files publicly available?

Have you made your any auxiliary design files publicly available? (optional)

Have you made a bill of materials publicly available?

Have you made photos of your product at various stages of assembly publicly available? (optional)

Have you made any instructions or other explanations publicly available? (optional)

Have you properly licensed your design files so that others may reproduce or build upon them?

Recommended Licenses for Documentation

CC0-1.0

A CC 0 public domain dedication is the most permissive option, which lets downstream users use your product documentation for any purpose without any limits. This license relinquishes any claim you may have over ownership of the product documentation.

This means that other open source hardware makers may use your product in way they see fit, as long as it confirms to the OSHWA Definition.

Other open copyright licenses may be acceptable under the OSHWA definition. We recommend Creative Commons, however, due to its widespread acceptance, recognition, and ease of use.

The use of any CC “NonCommercial (NC)” and “NoDerivatives (ND)” licenses are not permissible under the OSHWA Definition.

CC BY

A CC BY license allows downstream users to use your product documentation for any purpose, so long as they attribute their use back to you.

This means that other open source hardware makers need to attribute your original copyrighted documentation to you in order to comply with the terms of the license. Doing so allows them to use your documentation for any purpose that fits within the OSHWA Definition.

Other open copyright licenses may be acceptable under the OSHWA definition. We recommend Creative Commons, however, due to its widespread acceptance, recognition, and ease of use.

The use of any CC “NonCommercial (NC)” and “NoDerivatives (ND)” licenses are not permissible under the OSHWA Definition.

CC BY-SA

A CC BY-SA license allows downstream users to use your product documentation for any purpose, so long as they give appropriate attribution and license any new creations under the same terms as your license.

This means that other open source hardware makers need to (1) attribute your original copyrighted documentation to you and (2) allow others to license their new copyrighted material in the same manner in order to comply with the terms of the license. Doing so allows them to use your documentation for any purpose that fits within the OSHWA Definition.

Other open copyright licenses may be acceptable under the OSHWA definition. We recommend Creative Commons, however, due to its widespread acceptance, recognition, and ease of use.

The use of any CC “NonCommercial (NC)” and “NoDerivatives (ND)” licenses are not permissible under the OSHWA Definition.

Examples of Documentation Licensing

Checklist list

Checklist

Have you made your original design files publicly available?

Have you made your any auxiliary design files publicly available? (optional)

Have you made a bill of materials publicly available?

Have you made photos of your product at various stages of assembly publicly available? (optional)

Have you made any instructions or other explanations publicly available? (optional)

Have you properly licensed your design files so that others may reproduce or build upon them?

Commercialization

More original, robust documentation is likely to have stronger copyright protection, which can prevent against misuse. Copyright only protects against third parties misusing the product documentation itself, not against making a physical copy of the product by following the documentation instructions.

The definition of open-source hardware specifies that you must allow modification and commercial re-use of your design. That makes CC licenses with a no-derivatives or non-commercial clause incompatible with certification.