---
# System prepended metadata

title: Standard for Build Guides

---

# Standard for Build Guides

To create a keyboard build guide, follow the instructions below. Make note of any special hardware that specific build needs that may make it different from other builds.

To write a build guide for a keyboard please answer the questions below. Create a copy of this document, then write out answers to the questions in a clear & warm manner. Omit any questions that don’t apply to the keyboard build you are making a guide for.

:::note 
Be sure to make your writing welcoming and warm. Use vocabulary that states things in a helpful and friendly manner. You're building a keyboard with a friend, excited to make something new! With a side dish of poptart cat. 
:::

## Build Compatibility
### Is this build similar to other builds?
* List the other builds this is similar to: "Looks like you're working on the Iris! This build is similar to these other bilds: ... So be sure to choose beforehand what you're most excited to see in frontof your computer screen."

####  Watch out for...
* List things someone making this build should be careful of/aware of: “Read me first! Before you start, consider if you’d like to make these optional additions (and/or make a note of things a user needs to be careful of): [list]. It works to choose otherwise, but these choices are open to you if you’re into them!”

## Videos of Builds & Blogs
**Name of YouTuber in Bold** Title of video here.

List other blogs and websites that may include pointers or display support for the builds.

## Parts List
1. Have an image that showcases every item *needed* for the build. If there are optional items, include those in a separate image.
2. List all the items included from required items starting at the top of the list and otional items listed and labeled "optional" after required items.

## Build Steps Summary
List all the main points of the build, have *optional* items noted.

1. The first step for all the sets is going to be a recommendation for Flashing Firmware.
2. Other things will happen in different sequences

#Flashing Firmware
Provide a brief explanation and also direct readers to our ultimate flashing page. It's coming soon!

## Prepare Components
Advise the reader of helpful prep so they can proceed to begin the build. For example, if a user would be helped to fold diodes at this phase, instruct them to do so: “You’ll find the following steps easier if you fold diodes first. Hop to that, and then hop to the next step.”

## Solder Components
Advise the reader if certain things need to be soldered within a sequence or not. 
List *optional* soldering after *required* soldering (provided they don't hinder the other).
+ If there are any things missing from the build or needed workarounds, include them prior to the step where the issue might arise in the build

## Optional but needed in a certain sequence
Advise the reader of optional additions that can be made-but place them within the guide where it would be best handled.

## Solder Switches
Have any cautions about final soldering precede this section for the reader.

## Assembly
Following soldering parts together, if there is a specific sequence for the assembly of the items, number each item distinctly and clearly.

## Programming
As in builds like the Quefrency Rev. 2, programming is required before confluding the build. 

## Rejoice! 
You have a brand-new mechanical keyboard to aid your quest of computer usage with less strain on yours wrists in style!