Skip to content

Commit

Permalink
feat: Autogenerate API documentation on release
Browse files Browse the repository at this point in the history
  • Loading branch information
gyng committed Nov 17, 2021
1 parent eb505d5 commit f6fe79b
Show file tree
Hide file tree
Showing 3 changed files with 15 additions and 2 deletions.
2 changes: 1 addition & 1 deletion .github/workflows/generate-api-docs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ on:
types: [created]

jobs:
build_and_lint:
publish_docs:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
Expand Down
13 changes: 13 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# esbuild-quickstart

[Example API documentation](https://gyng.github.io/esbuild-quickstart/)

Quickstart for esbuild library projects. Depends on `yarn`.

- Typescript
Expand Down Expand Up @@ -41,6 +43,15 @@ Build targets are set in `esbuild.js`.

3. Update the `scope` key in `./github/workflows/publish.yml` to your GitHub (organisation) name

4. Configure GitHub Pages

```
https://github.com/gyng/esbuild-quickstart/settings/pages
```

- Source: `gh-pages` branch
- Directory: `/ (root)`

### Run

1. Bump your version number in `package.json` before this. Publishing will fail if the version already exists.
Expand All @@ -52,3 +63,5 @@ Build targets are set in `esbuild.js`.
```

The workflow at `./github/workflows/publish.yml` should run and publish your packages to both NPM and GitHub Packages.

Also, API documentation will be published to your GitHub pages via the `gh-pages` branch. It will be viewable at `https://$YOUR_NAME.github.io/$YOUR_REPO/`.
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@gyng/esbuild-quickstart",
"version": "1.1.0",
"version": "1.2.0",
"main": "lib/cjs/index.js",
"module": "lib/esm/index.js",
"types": "lib/types/index.d.ts",
Expand Down

0 comments on commit f6fe79b

Please sign in to comment.