Skip to content

Commit

Permalink
docs/packaging: Update release process for package (un)deprecation
Browse files Browse the repository at this point in the history
  • Loading branch information
joebonrichie committed Jun 8, 2024
1 parent 8d11c38 commit d586db1
Showing 1 changed file with 9 additions and 8 deletions.
17 changes: 9 additions & 8 deletions docs/packaging/procedures/release-processes.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,23 +33,24 @@ Deprecated packages will remove themselves from the users systems as the first o

Follow these steps to submit a package for deprecation:

1. Fork and clone the `solus-sc` repo [on GitHub](https://github.com/getsolus/solus-sc), and/or create a new branch
1. Create a new branch in the monorepo [on GitHub](https://github.com/getsolus/packages) (forking the repository first if necessary) with a suitable name such as deprecate-foobar
2. Edit `repo_data/distribution.xml.in`
3. Add the package you wish to deprecate at the end of the `<Obsoletes>` section
4. Run the `merged_repos.sh` script
4. Change directory to repo_data (`cd repo_data`), then run the `merged_repos.sh` script
5. Remove the package from the monorepo, for example `rm -fr packages/f/foobar`
5. Commit and push your changes to your repository/branch
6. Open a Pull Request on GitHub

If a deprecation depends on a packaging change landing before it can be properly deprecated without undesirable side effects on user systems, the GitHub deprecation Pull Request MUST link to the packaging change and declare it as a dependency for deprecation.

### Un-deprecating a package

The above steps also apply to un-deprecating a package, with the following additions:

1. Before making changes, the package repository must be reactivated
2. In Step 2, remove the package from the list instead of adding it
3. After the `solus-sc` pull request has been merged, ask a Solus Staff member to use available tooling to update the repository files, then index the repo with `ferryctl index unstable` (or do it yourself if you have the ability)
4. Bump or update the package
1. Create a new branch in the monorepo [on GitHub](https://github.com/getsolus/packages) (forking the repository first if necessary) with a suitable name such as undeprecate-foobar
2. Find the commit deprecating the package and restore the package within the monorepo structure. For example restore all files in packages/f/foobar or use `git revert` if appropriate
3. Edit `repo_data/distribution.xml.in` and remove the package you wish to undeprecate in the `<Obsoletes>` section
4. Change directory to repo_data (`cd repo_data`), then run the `merged_repos.sh` script
5. Open a Pull Request on GitHub and ask a Solus Staff member to use available tooling to update the repository files, then index the repository with `ferryctl index unstable` (or do it yourself if you have the ability)
6. Bump or update the package

## Major stack changes

Expand Down

0 comments on commit d586db1

Please sign in to comment.