Skip to content

bseverns/machine-docs

Repository files navigation

Fabrication Machines — Living Docs

A practical, evolving field manual for our digital fabrication lab. Built to help people make more, better, and safer.

  • Scope: 3D printers (MakerBot Sketch, Sketch+, Method X; LulzBot Mini 3) and CNC (Genmitsu Cubiko).
  • Audience: students, staff, and community members — from first-timers to battle-tested maintainers.
  • Status: initial scaffold · 2025-09-19. Treat it like a handbook and a lab log that never sleeps.

Why this repo exists

We keep tripping over the same questions: Which profile do I use? Where do I log the weird noise? Rather than repeat tribal knowledge, this repo captures the intent behind every job. Every doc should teach you how to succeed today and how to leave breadcrumbs for the next operator.

The lab is a chorus; every operator should leave it singing a little more in tune.

Quick orientation

How to use these docs

  1. Start in your machine folder → read the local README → follow its linked Quick Start, Safety, and SOP.
  2. Grab the relevant Operator Checklist, templates, or slicer profiles directly from the folder paths linked in each doc.
  3. After every run, update the maintenance or incident logs so the next human sees the full story, then hit the Machine Logging Playbook to stay synced on review cadence.
  4. Found a better trick? Submit a PR with context, photos, or data. This repo only stays alive if we feed it.

Contribution rhythm

  • Small fixes — Quick typo, new photo, or parameter tweak? Open a PR with a tight diff and before/after notes.
  • New procedures — Fork the SOP template or other scaffolds and document the “why” alongside the “how”.
  • Incidents — Log the event in the machine’s incident log within 24 hours and open an issue so we can swarm it.

Firmware policy

All machines run stock firmware unless their machine page calls out a controlled deviation. Personal machines include explicit firmware notes and links; don’t freestyle without documenting the rollback path.


Need something that isn’t here yet? Open an issue, drop your context, and let’s hack the gap together.

About

A catalog of digital manufacturing equipment and procedures

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages