Baker's Demo Project
Here is my example project. This should give you a good idea of the layout and format for your documentation.
Record your research and background information in this section
Supplies
List the parts, materials, tools/equipment you need. Aim to make this list as complete as possible, remember your gold standard here is that anyone should be able to follow this Instructable and make a completely functional product.
Bill of Materials
- Raspberry Pi Pico W
- 4x Momentary Push Buttons
- 500mm NeoPixel LED Strip
- Hookup Wire
Tools & Equipment
- Soldering Iron
- 3D Printer
- Side cutters
- Wire Strippers
Wiring Diagram
Here is an example wiring produced using the Cirkit Designer App. You can have a look at it in the app > HERE <
Follow THIS TUTORIAL to get started using Cirkit.
NOTE: The tutorial shows an Arduino Microcontroller. We're using RPi Pico, but all the things to click on are the same. Just a different board. 😉
Production Steps Here
Add as many steps as you need to document your project. Here are some tips for this:
- Balance the number of steps with the detail required. You don't want really long, detailed steps OR hundreds of tiny steps. In general - the fewer the better.
- Make each step as complete as possible - everyone hates instructions where new items, materials, etc. are introduced but not mentioned previously!
- Keep your writing to the point. I'm marking on clarity, accuracy and how well you communicate what's needed. NOT on length.
- Use the text editing features to highlight key information and keep things visually interesting. See the examples below.
Block Quotes
This is a block quote. Use it to highlight important information or provide context to the reader.
Links
Use links to sites to document references or resources that people may need.
Example:
🔗 Button debouncing and counting with interrupts
Code Blocks
This is a code block.
It highlights code for the reader and makes it easy to copy and paste into the IDE.
Code
import utime
import dht
from machine import Pin, ADC
# Setup sensors
dht_sensor = dht.DHT11(Pin(28))
light_sensor = ADC(Pin(26))
while True:
# Read DHT11 (temp/humidity)
dht_sensor.measure()
temp = dht_sensor.temperature()
hum = dht_sensor.humidity()
# Read LDR (light level as a 16-bit value)
light_val = light_sensor.read_u16()
# Convert ADC to percentage (if desired)
light_pct = (light_val / 65535) * 100
print("Temp: {}°C, Humidity: {}%, Light: {:.1f}%".format(temp, hum, light_pct))
utime.sleep(2)