Add the deploy step for gh pages

[ericdill]

Description

follow up from #376

you'll need to make some changes on the settings pages

then, a multi-step change is needed:
step 1:

step 2:

Once the above things have been set, the docs should push on any tag that gets pushed to this repo.

[jezdez]

pre-commit.ci autofix

[ericdill]

@jezdez fixed the linter issue

[xhochy]

@jezdez You need to change the environments setting. I cannot do that.

[dbast]

The current settings:

Looks correct to be and ready to merge.

[dbast]

failed https://github.com/conda/conda-pack/actions/runs/11853502765/job/33034332675

[xhochy]

Probably https://github.com/conda/conda-pack/actions/runs/11853502765/workflow#L154 also needs to be patched.

[dbast]

The error is: Error: No artifacts named "github-pages" were found for this workflow run. Ensure artifacts are uploaded with actions/upload-artifact@v4 or later.

Both actions:

• https://github.com/actions/upload-pages-artifact
• https://github.com/actions/deploy-pages

list the default for artifact_name to be github-pages and we do not overwrite that.

The issue is: https://github.com/conda/conda-pack/actions/runs/11853502765/workflow#L152 ... upload happens only when tagged.

[xhochy]

We also need to allow tags for the environment:

[jezdez]

@jezdez You need to change the environments setting. I cannot do that.

Can you try again?

[xhochy]

I did rerun the job https://github.com/conda/conda-pack/actions/runs/11859545372/job/33061200057 and it keeps failing

[jezdez]

@xhochy I've fixed the environment protection rule to allow tags as well as the main branch, and now reran the whole steps (since the docs artifact has been been invalidated): https://github.com/conda/conda-pack/actions/runs/11859545372