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

Implement Auto-Publishing of Docs to GitHub Pages (Issue #333) #340

Conversation

TechWizard9999
Copy link

This pull request addresses Issue #333, which involves setting up automatic documentation generation and publishing to GitHub Pages using Typedoc and GitHub Actions.

Typedoc Setup: Added Typedoc as a dev dependency and configured it to generate documentation from the TypeScript source files.
GitHub Actions Workflow: Created a new workflow (publish-docs.yml) under .github/workflows/ to automate the documentation deployment process. This workflow is triggered on new tag pushes and manual dispatches.
Documentation Configuration: Included a typedoc.json file with the necessary settings for documentation generation.

Copy link

codesandbox bot commented Dec 8, 2023

Review or Edit in CodeSandbox

Open the branch in Web EditorVS CodeInsiders

Open Preview

@frankhinek frankhinek linked an issue Dec 8, 2023 that may be closed by this pull request
Comment on lines +3 to +7
on:
push:
tags:
- '*'
workflow_dispatch:
Copy link
Contributor

Choose a reason for hiding this comment

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

Seems like we'd only want this to run when a commit on main is tagged, correct?

Otherwise tagging a release candidate on a branch or any other tag on a non-main branch would update docs

.github/workflows/publish-docs.ym Show resolved Hide resolved
.github/workflows/publish-docs.ym Outdated Show resolved Hide resolved
.github/workflows/publish-docs.ym Outdated Show resolved Hide resolved
.github/workflows/publish-docs.ym Outdated Show resolved Hide resolved
.github/workflows/publish-docs.ym Show resolved Hide resolved
package.json Show resolved Hide resolved
@frankhinek frankhinek mentioned this pull request Dec 8, 2023
@frankhinek frankhinek requested a review from leordev December 8, 2023 21:05
@TechWizard9999 TechWizard9999 deleted the issue-333-auto-publish-docs branch December 10, 2023 06:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

auto publish docs in gh pages
2 participants