Respect your user's time. Every workaround we skip in the infrastructure is a hoop the user has to jump through. Do the long, proper thing once so users get a zero-friction experience. If a fix requires the user to act, the real fix hasn't shipped yet.
This philosophy applies to every repository in the organization. When contributing, keep it in mind:
- No hacks. If a solution requires the user to run an extra command, add a flag, or read a workaround — the real fix hasn't shipped yet.
- No documented workarounds. Documentation is not a substitute for solving the problem upstream.
- Do it once, do it right. The long way done properly is shorter than the shortcut done twice.
Each repository has its own README with setup instructions and a
make help target. Start there.