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

chore: integrate docs into CI #315

Closed
atruskie opened this issue Apr 22, 2020 · 0 comments · Fixed by #430
Closed

chore: integrate docs into CI #315

atruskie opened this issue Apr 22, 2020 · 0 comments · Fixed by #430

Comments

@atruskie
Copy link
Member

Is your feature request related to a problem? Please describe.

The docs are currently only published manually.

Describe the solution you'd like

Our CI should deploy the docs.

Related to #313

atruskie added a commit that referenced this issue Feb 1, 2021
Docs get built and published (to netlify) on commit.

Also builds docs as a downloadable PDF.

This is a combination of 6 commits.

add first github actions workflow

for docs building

Adds CI actions for building and publishing docs

Also adds a PDF variant of the docs

Fixed a bug in the asset chooser html

Reorganized a few sections

Added a new `index` document type that will list all the pages in  the current section after the conceptual content.

Generalized the git version file so that it can output key-value, json, CI commands, or environment variables!

Remove unnecessary gh docfx download

limit choco logs

Avoid nostdin

dotnet/docfx#4488

wkhtmltopdf/wkhtmltopdf#4450

Add netlify auth token

Fixes #315
atruskie added a commit that referenced this issue Feb 1, 2021
Related to #315

- only do prod deploy when a commit is pushed to master
- publish a github commit status that will show the url of the deploy that netlify does (for site previewing)

The following is a squashed set of commits that tried to use the GitHub Checks API but ultimately failed.
Checks are made for GitHub apps which are very complicated.

---

Docs CI fixes

Not sure output variables were working
Also there are race conditions with check-runs - seeing how a github status differs

wild guesses

Update docs.yml

Fix member access for pscustomobject

Ensure deploy scripts can use auth token

So GH's API does not rate limit them

Attempt to publish check early

Fix typo

another idea

Remove check runs - cant get them to work

DX bad git-version on GA

update title
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging a pull request may close this issue.

1 participant