Skip to content

Auto-publish TypeDoc to gh-pages #62

Description

@Miracle656

Background

Wraith's internal modules are useful as a Node library too, but they're undocumented. TypeDoc can generate a browsable API reference from the existing TSDoc comments with zero new content authoring.

What to build

A workflow that runs typedoc and pushes the HTML output to gh-pages on every main push.

Key files

  • New: typedoc.json
  • New: .github/workflows/typedoc.yml

Suggested execution

git checkout -b ci/typedoc-publish
  1. npm i -D typedoc
  2. Configure typedoc.json with entryPoints covering the public modules
  3. Workflow runs npx typedoc and pushes docs/ to gh-pages via peaceiris/actions-gh-pages
  4. README links to the hosted docs

Example commit message:
ci(docs): auto-publish TypeDoc API reference to gh-pages

Acceptance criteria

  • TypeDoc HTML appears on gh-pages
  • Workflow runs on every main push
  • README links to the URL
  • No errors in typedoc output

Drips Wave · Complexity: Trivial · 100 points
Comment below to request assignment. PR must include Closes #[this issue].

Activity

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

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions