# How to add a release-specific version to helm-www

These steps explain how to setup a release-specific version of helm.sh for archival purposes.

## Process:

1. When a new release of Helm is cut (say 3.3), ensure you fetch the latest master to include any recent doc changes in the helm-www repo.

2. Create a new branch from master with the version name (e.g. `version-3-3-0`)


3. Edit the site to act as an archival version of Helm.sh:

3.1 Update the config.toml with a new baseurl ([example](https://github.com/helm/helm-www/commit/6b4100c2d7b552e957827e71205e740ebd7db2a0#diff-618063036395fe9ee107f22b46c9eadeL1)). Example:

    https://v3-3-0.helm.sh/
    https://v3-2-0.helm.sh/
    https://v3-1-0.helm.sh/

3.2 Review the version currently displayed as the _latest stable_. Update if outdated ([example](https://github.com/helm/helm-www/blob/6b4100c2d7b552e957827e71205e740ebd7db2a0/config.toml#L39L400)).

3.3 Update the config.toml with a new dropdownentry for the release version ([example](https://github.com/helm/helm-www/commit/6b4100c2d7b552e957827e71205e740ebd7db2a0#diff-618063036395fe9ee107f22b46c9eadeR44)).

3.4 Commit these changes to your new versioned branch (`version-X-Y-Z`).

4. Push this branch to upstream.

5. Login to Netlify and go to the Helm [team account](https://app.netlify.com/teams/helm/sites).
_Access is controlled by CNCF and Helm team members (ping @flynnduism)._


6. Create a 'New site from Git'. Select the Github option.


Note: If this is your first time creating a Netlify site for Helm, you may be prompted to authenticate Netlify access via your Github account.

7. Set the branch and build command for the site.

7.1 Select the branch you created in step 2 above (`version-X-Y-Z`).
7.2 Ensure the build command is `hugo --minify` and public directory is `app`.
7.3 Click the 'Deploy Site' button to build the site.


The is site is created with a randomized name:


If the build process should fail, please [create an issue](https://github.com/helm/helm-www/issues/new) to flag the problem.

8. Update the site name and url:

8.1 Click the site settings button. Give the site a descriptive name. The _name_ value is for descriptive purposes in Netlify, it will not affect the url.


8.2 In the Settings view, chose Domain management in the menu on the left. Click 'Add a custom domain' to create a subdomain under `*.helm.sh`. The domain should follow the same format as existing subdomains:

    v3-1-0.helm.sh
    vX-Y-Z.helm.sh


Click Yes.


Once added, you should also make sure to enable Https but clicking the 'Force HTTPS' button.


9. Once the site deploy is finished and the custom domain is added, the site will be live at the new domain you created. The whole process should take around 1-2 minutes to build and deploy.