CI generated docs on scala3doc.virtuslab.com

[romanowski]

From scala3doc. It includes documentation for dotty, scala3doc and scala3doc-testcases

This PR requires a secret AZURE_STORAGE_SAS_TOKEN to be added to work.

[romanowski]

Confoguration works on my private fork where I can control secrets.
See example build and generated documentation

[smarter]

Could we upload to github pages like we do for the existing docs?

[romanowski]

Could we upload to github pages like we do for the existing docs?

Once we switch to scala3doc by default we will do that for sure.

The main goal for this PR is to have generated documentation for development of scala3doc similar to what we've got on scala3doc

[abgruszecki]

@romanowski it seems we have hit a problem. I've added the secret you've sent me, but it seems that GH simply refuses to pass secrets to workflows ran from a fork, which is the default workflow for us here in Dotty land. GH docs don't suggest any workaround. A quick Google search didn't help either. I think we could try to embed the secret inside our container, but that's a bit painful to maintain. Any other suggestions?

[smarter]

Merge scala3doc.yaml and ci.yaml into one file?

[abgruszecki]

@smarter I guess we can do that, but I don't understand how that is supposed to help?

[smarter]

I thought from what you said that the issue was due to using a different workflow?

[abgruszecki]

The problem is that the PR references a branch on a fork of Dotty repo, which is what dotty-staging/dotty is. Workflows ran on such a PR don't get to see any secrets, not even ones in the fork apparently.

[romanowski]

I've changed apporach and now we are now using pull_request_target trigger that runs checks on target branch on PR (I checkout to PR code) and its allow it to use secrets.

It means that is uses CI configuration from target branch and to see how it will work when merged I create this PR where this branch is a PR target.

[abgruszecki]

Trigger for the workflow was changed to pull_request_target, which uses config from PR target and so, has available secrets. This PR was tested in another repo here: VirtusLab#4, so it LGTM.