| typeId | publication_series | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| recordId | webuild | ||||||||
| fields |
|
A publication series about hardware building, documenting the process, decisions, and techniques we use to create physical things.
We Build is narrative/editorial content about the journey of building hardware projects. Unlike product documentation (specifications, BOMs, assembly instructions), this series focuses on:
- Process: How we approached problems and made progress
- Decisions: Why we chose specific components, techniques, or approaches
- Techniques: Methods and workflows we developed or refined
- Learning: What worked, what didn't, and what we'd do differently
This repository is structured as a GraphMD dataset for metadata management while maintaining author-friendly organization.
(No published articles yet)
- Example Article: Setting Up Your Workshop — A sample article demonstrating the publication format
pub-webuild/
├── articles/ # Published and draft articles
│ ├── YYYY-MM-slug/ # Published articles (date-prefixed)
│ └── drafts/ # Work-in-progress articles
├── types/ # GraphMD type definitions
├── docs/ # Publication policy documentation
│ ├── decisions/ # ADRs (Architectural Decision Records)
│ └── rfcs/ # RFCs (Request for Comments)
└── tools/ # Validation tooling
- Node.js 20+
- npm
npm ci # Install dependencies (deterministic)
npm test # Validate GraphMD datasetThis publication series follows:
- Conventional Commits for commit messages (enforced via commitlint)
- GraphMD dataset validation in CI (all articles have proper metadata)
- Single authorship principle (no Co-Authored-By or external attribution)
See CLAUDE.md for detailed guidance on publication workflows.
- Documentation Index — Policy ADRs and RFCs
- CHANGELOG — Publication history
- LICENSE — CC BY 4.0
This work is licensed under a Creative Commons Attribution 4.0 International License.
You are free to share and adapt this content with attribution.