# Release Procedure

1. Stage environment.

    1. Checkout to `master`.

    2. Fetch latest changes in `origin/master`.

    3. Ensure it is up to date with `origin/master` and there are no pending changes locally.

        ```
        git checkout master && git fetch origin master && git status
        ```

2. Verify current revision builds are green on [https://github.com/kafji/lembaran](https://github.com/kafji/lembaran).

3. Update documents.

    1. Bump version in [Cargo.toml](../Cargo.toml).

        ```toml
        version = "0.2.0"
        ```

    2. Bump version in [README.md#installation](../README.md#install)

        ```toml
        version = "0.2"
        ```

    3. Update the changelog entries in [CHANGELOG.md](../CHANGELOG.md).

        ```
        ## [0.2.0](https://github.com/kafji/lembaran/tree/v0.2.0) - 2021-12-31

        - Fix a thing

        ```

4. Commit changes.

    ```
    git commit -am "Prepare release 0.2.0"
    ```

5. Verify crate can be published to Cargo.

    ```
    cargo publish --dry-run
    ```

6. Create tag.

    ```
    git tag v0.2.0
    ```

7. Publish the commit and the tag.

    ```
    git push origin master && git push --tags origin
    ```

8. Publish crate to Cargo.

    ```
    cargo publish
    ```