Contribute & Co-Create

WorkBuddy's capabilities, UI and usage keep changing. This field guide hopes to be co-maintained by real users: not just correcting facts, but continuously adding reproducible tasks, failure experience and team methods.

What You Can Contribute

Fix typos, dead links, outdated UI and inaccurate wording.
Add a real, reproducible WorkBuddy case.
Add input, output, acceptance criteria and failure handling to existing cases.
Add role or industry workflows.
Improve screenshots, charts, navigation and accessibility.

Submit a Community Case

If you've run a real task through in WorkBuddy, prefer submitting it to the community case collection. Each case must explain the scenario, Skills used, the steps in WorkBuddy, the final effect and acceptance criteria.

First read the case submission guide. After the PR merges, the case auto-appears in the site's case collection; classic tasks that are further reproduced and edited may later enter the field guide proper.

Lightest Way: File an Issue

If you don't want to edit files for now, state in GitHub Issues:

Which page needs adjusting.
What the current problem is.
How you suggest changing it.
If it involves product facts, attach a source or screenshot.

Edit Content Directly

Fork or clone the repo.
Find the relevant chapter's index.md under docs/bluebook/.
Edit the content or add assets in the same directory's assets/.
Run npm install and npm run docs:build locally.
Open a Pull Request, explaining the change, reason and how you verified it.

Full spec in the repo root's CONTRIBUTING.md.

Content Principles

Real tasks first: explain input, steps, deliverables and how to accept.
Separate fact from experience: attach sources to product facts; state applicable conditions for personal experience.
Beginner-friendly: don't assume the reader knows the tools, permissions or terminology.
Clear safety boundaries: explain risks when involving files, accounts, keys, publishing and external operations.
Respect privacy and copyright: don't submit keys, personal data or material you're not authorized to publish.

Contact Us

If you want to discuss co-creation ideas, submit a case, or join the field guide's ongoing maintenance, you can scan a QR code to reach us. Click an image to view larger.