Skip to content

Week 01

01

Principles and Practices

January 2026

What I Did

Set up the documentation infrastructure. Git, MkDocs, basic site structure.

Also started thinking through the final project scope, what’s realistic, what hardware I’ll need, estimate a timeline bla bla…

Git

Configured Git with SSH keys for the Fabcloud GitLab:

git config --global user.name "Pedro Rocha"
git config --global user.email "pedro@example.com"
ssh-keygen -t ed25519 -C "pedro@example.com"

The workflow I’ll be using:

git pull
git add <files>
git commit -m "commit msg"
git push

Site Structure

docs/
├── index.md
├── about/
│   └── index.md
├── assignments/
│   └── week01.md
├── projects/
│   └── final-project.md
└── stylesheets/
    └── extra.css

Using MkDocs Material with a dark theme. Customized the colors and typography to match the cybersecurity aesthetic I wanted.

Notes

Things to remember for the program:

  • Keep images under 1MB
  • Repo soft limit is 300MB
  • Commit often with useful messages

Next

  • Start CAD for the enclosure
  • Research PCB fabrication options
  • Prototype the backplane connector