Skip to content

Commit

Permalink
Added documentation about the new version branches
Browse files Browse the repository at this point in the history
Fixes #1740
  • Loading branch information
mpscholten committed Jul 16, 2023
1 parent 142c32c commit faec55e
Showing 1 changed file with 31 additions and 0 deletions.
31 changes: 31 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -137,6 +137,37 @@ main

After creating a new test you need to still call it from the `Main` module by adding it to `IHP/Test/Main.hs`.

## Branches

Since the switch to nix flakes with IHP v1.1 we're using release branches, to make it easy to upgrade IHP versions using `nix flake update`.

E.g. there's a [branch named `v1.1`](https://github.com/digitallyinduced/ihp/tree/v1.1) that contains the latest IHP v1.1.x release. When a new IHP v1.1.x release is made, we'll update the `v1.1` branch to point to the new release commit.

IHP apps have a `flake.nix` like this:

```nix
{
inputs.ihp.url = "github:digitallyinduced/ihp/v1.1";
}
```

This means that whenever someone runs `nix flake update`, they'll get the latest commit from the IHP v1.1 branch.

To upgrade to a newer minor version, the URL can be changed to use IHP from the e.g. `v1.2` branch:

```nix
{
inputs.ihp.url = "github:digitallyinduced/ihp/v1.2";
}
```

### New Releases

When we're preparing a new release, e.g. the IHP v1.2.0 release, we'll create a new branch `v1.2` and merge the current master into that branch.

Additionally every released version of IHP is tagged. [You can see a list of all tags on GitHub.](https://github.com/digitallyinduced/ihp/tags)


## Troubleshooting

### `can't satisfy package ihp`
Expand Down

0 comments on commit faec55e

Please sign in to comment.