Skip to content

Commit 128c26e

Browse files
authored
ci: generate reference documentation (#64)
1 parent ce6fe20 commit 128c26e

File tree

6 files changed

+71
-3
lines changed

6 files changed

+71
-3
lines changed

.github/workflows/deploy-doc.yml

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
name: Deploy Ref Doc
2+
3+
on:
4+
# Runs on tags
5+
push:
6+
tags:
7+
- '**'
8+
9+
# Allows you to run this workflow manually from the Actions tab
10+
workflow_dispatch:
11+
12+
# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
13+
permissions:
14+
contents: read
15+
pages: write
16+
id-token: write
17+
18+
# Allow one concurrent deployment
19+
concurrency:
20+
group: "pages"
21+
cancel-in-progress: true
22+
23+
# Default to bash
24+
defaults:
25+
run:
26+
shell: bash
27+
28+
jobs:
29+
# Build job
30+
build:
31+
runs-on: ubuntu-20.04
32+
steps:
33+
- name: Checkout
34+
uses: actions/checkout@v3
35+
with:
36+
fetch-depth: 0
37+
- name: Setup PNPM
38+
uses: pnpm/[email protected]
39+
- name: Setup Node
40+
uses: actions/[email protected]
41+
with:
42+
node-version: 17
43+
check-latest: true
44+
cache: 'pnpm'
45+
- name: Setup Pages
46+
id: pages
47+
uses: actions/configure-pages@v1
48+
- name: Install dependencies
49+
run: pnpm install
50+
- name: Build doc
51+
run: pnpm run doc
52+
- name: Upload artifact
53+
uses: actions/upload-pages-artifact@v1
54+
with:
55+
path: ./docs
56+
57+
# Deployment job
58+
deploy:
59+
environment:
60+
name: github-pages
61+
url: ${{ steps.deployment.outputs.page_url }}
62+
runs-on: ubuntu-20.04
63+
needs: build
64+
steps:
65+
- name: Deploy to GitHub Pages
66+
id: deployment
67+
uses: actions/deploy-pages@v1

.github/workflows/deploy.yml renamed to .github/workflows/deploy-package.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
name: Deploy
1+
name: Deploy to NPM
22

33
on:
44
workflow_dispatch:
File renamed without changes.

packages/clients/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
This SDK enables you to interact with Scaleway APIs.
44

55
**🔗  Important links:**
6-
* Reference documentation (soon)
6+
* [Reference documentation](https://scaleway.github.io/scaleway-sdk-js)
77
* [Example projects](https://github.com/scaleway/scaleway-sdk-js/tree/master/examples)
88
* [Developers website](https://developers.scaleway.com) (API documentation)
99

typedoc.json

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,5 +6,6 @@
66
"out": "docs",
77
"excludeInternal": true,
88
"excludePrivate": true,
9-
"excludeProtected": true
9+
"excludeProtected": true,
10+
"readme": "none"
1011
}

0 commit comments

Comments
 (0)