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

Initial work to add a mdbook documentation style #856

Open
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

dblnz
Copy link
Contributor

@dblnz dblnz commented Feb 15, 2025

On top of the work mentioned in #848, this adds a workflow that deploys the documentation on change

Mossaka and others added 3 commits February 15, 2025 18:00
Signed-off-by: Jiaxiao (mossaka) Zhou <[email protected]>
if: ${{ github.ref == 'refs/heads/main' }}
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
publish_dir: ./docs/book
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does this build the docs on https://containerd.github.io/runwasi/docs/book?

Copy link
Contributor Author

@dblnz dblnz Feb 18, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No, what it does is:

  • it generates the website at that path
  • takes the files and commits them to gh-pages branch which can be selected as source for a Github Page.

The problem is it will use the same URL: https://containerd.github.io/runwasi
So, we need to somehow merge the benchmarks with the book also

I looked briefly for ways to define a different path, but it doesn't seem to work. The only other option would be to use a custom domain

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@devigned FYI - can we use the runwasi.dev website?

@Mossaka Mossaka linked an issue Feb 20, 2025 that may be closed by this pull request
4 tasks
Copy link
Collaborator

@jprendes jprendes left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@@ -0,0 +1,6 @@
[book]
authors = ["Runwasi Team"]
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit:

Suggested change
authors = ["Runwasi Team"]
authors = ["Runwasi Authors"]

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

Successfully merging this pull request may close these issues.

Centralized Documentation with mdBook for runwasi
3 participants