Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Publish coverage and docs to GH Pages #16

Merged
merged 1 commit into from
Jun 30, 2024
Merged

Conversation

JustinKuli
Copy link
Owner

@JustinKuli JustinKuli commented Jun 30, 2024

Previously, the coverage reports were pushed to the wiki, but since the wiki is not meant for serving arbitrary HTML, viewing them properly required going through raw.githack.com.

Also, the main pkg.go.dev site does not handle this repository well, possibly because it is a fork (also complicated by the archiving of the original) or because downloads of the package are very rare. Based on a suggestion in github (dot) com/golang (slash) go/issues/2381, an updated GH action now downloads the contents of a local documentation server with wget, and modifies some local links with sed to get something which can be statically served. This mostly works, the main downside is that JS files seem to be missing.

This adds on to the existing test step in the action, because that step is necessary for the coverage information. If additional resources are to be served on the GH Pages site, it might be a good idea to move to a separate workflow, even though it would require re-running the tests.

Copy link

Code Coverage Report for this branch (might be slow to update): Go Coverage

This comment was marked as outdated.

.github/workflows/checks.yaml Show resolved Hide resolved
.github/workflows/checks.yaml Show resolved Hide resolved
.github/workflows/checks.yaml Show resolved Hide resolved
Previously, the coverage reports were pushed to the wiki, but since the
wiki is not meant for serving arbitrary HTML, viewing them properly
required going through `raw.githack.com`.

Also, the main `pkg.go.dev` site does not handle this repository well,
possibly because it is a fork (also complicated by the archiving of the
original) or because downloads of the package are very rare. Based on a
suggestion in github (dot) com/golang/go (slash) issues/2381, an updated
action now downloads the contents of a local documentation server with
`wget`, and modifies some local links with `sed` to get something which
can be statically served. This mostly works, the main downside is that
JS files seem to be missing.

This adds on to the existing test step in the action, because that step
is necessary for the coverage information. If additional resources are
to be served on the GH Pages site, it might be a good idea to move to
a separate workflow, even though it would require re-running the tests.

Signed-off-by: Justin Kulikauskas <[email protected]>
@JustinKuli JustinKuli merged commit fc60c2d into main Jun 30, 2024
5 checks passed
@JustinKuli JustinKuli deleted the local-cov-and-doc branch June 30, 2024 02:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant