|
| 1 | +# Version 1.0.0 release criteria |
| 2 | + |
| 3 | +Version 1.0.0 is the first stable release of MacDevSetup. |
| 4 | + |
| 5 | +This release establishes the repository as a production-ready macOS development setup with a documented CLI, selectable setup profiles, update and uninstall flows, and quality checks suitable for ongoing maintenance. |
| 6 | + |
| 7 | +## Repository quality |
| 8 | + |
| 9 | +- [x] The working tree is clean before release preparation. |
| 10 | +- [x] All intended release files are committed on `main`. |
| 11 | +- [x] `pre-commit run --all-files` completes successfully. |
| 12 | +- [x] Markdown files pass `markdownlint-cli2`. |
| 13 | +- [x] Repository formatting passes `editorconfig-checker`. |
| 14 | +- [x] Secret scanning reports no detected secrets. |
| 15 | +- [x] Documentation links are covered by the configured validation workflow. |
| 16 | + |
| 17 | +## Versioning and metadata |
| 18 | + |
| 19 | +- [x] Package metadata declares version `1.0.0`. |
| 20 | +- [x] Package lock metadata declares version `1.0.0`. |
| 21 | +- [x] The bundled French OSS keyboard layout metadata declares version `1.0.0`. |
| 22 | +- [x] Package metadata uses the repository MIT license. |
| 23 | +- [x] The changelog contains a dated `1.0.0` section. |
| 24 | + |
| 25 | +## Installer and CLI |
| 26 | + |
| 27 | +- [x] The global installer is documented in the README. |
| 28 | +- [x] The `mac` command exposes setup, doctor, update, and uninstall workflows. |
| 29 | +- [x] CLI command discovery and metadata are documented. |
| 30 | +- [x] Setup profiles support full and minimal installations. |
| 31 | +- [x] Uninstall and rollback behavior is documented. |
| 32 | + |
| 33 | +## Homebrew environment |
| 34 | + |
| 35 | +- [x] The root `Brewfile` remains the default full package inventory. |
| 36 | +- [x] Profile-specific Brewfiles are available for full and minimal setups. |
| 37 | +- [x] Homebrew package inventory documentation is up to date. |
| 38 | +- [x] Accepted command-line and application tools are documented. |
| 39 | + |
| 40 | +## Shell and configuration |
| 41 | + |
| 42 | +- [x] Zsh configuration is documented. |
| 43 | +- [x] Git configuration is documented. |
| 44 | +- [x] Visual Studio Code configuration is documented. |
| 45 | +- [x] Warp terminal configuration is documented. |
| 46 | +- [x] macOS defaults and keyboard layout setup are documented. |
| 47 | + |
| 48 | +## GitHub Actions and automation |
| 49 | + |
| 50 | +- [x] Repository quality validation is configured in GitHub Actions. |
| 51 | +- [x] Homebrew validation is configured in GitHub Actions. |
| 52 | +- [x] macOS validation is configured in GitHub Actions. |
| 53 | +- [x] Release Please automation is configured for future releases. |
| 54 | +- [x] Dependabot monitors GitHub Actions dependencies. |
| 55 | + |
| 56 | +## Documentation |
| 57 | + |
| 58 | +- [x] The README describes installation, setup profiles, CLI usage, and managed files. |
| 59 | +- [x] Troubleshooting documentation covers common setup issues. |
| 60 | +- [x] Architecture documentation explains CLI discovery. |
| 61 | +- [x] Release process documentation describes changelog, validation, tagging, and publication steps. |
| 62 | +- [x] Security and contribution policies are present. |
| 63 | + |
| 64 | +## Release |
| 65 | + |
| 66 | +- [x] The final release preparation commit follows repository commit conventions. |
| 67 | +- [ ] The release preparation commit is pushed to `main`. |
| 68 | +- [ ] GitHub Actions pass on `main`. |
| 69 | +- [ ] The release is tagged `v1.0.0`. |
| 70 | +- [ ] The tag is pushed to GitHub. |
| 71 | +- [ ] A GitHub release is created from the `v1.0.0` tag. |
0 commit comments