Skip to content

Commit

Permalink
reduce noise from doc generation (#600)
Browse files Browse the repository at this point in the history
Closes: #598
  • Loading branch information
andrew-codes authored Oct 27, 2024
2 parents a512e6b + 7f488db commit c120d88
Show file tree
Hide file tree
Showing 36 changed files with 51 additions and 50 deletions.
28 changes: 0 additions & 28 deletions .github/workflows/pull-request-release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -12,34 +12,6 @@ permissions:
pull-requests: write

jobs:
generate_docs:
name: Generate Docs
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
token: ${{ secrets.DOCUMENTATION_GITHUB_TOKEN }}
ref: ${{ github.head_ref }}
- name: Extract node version from package.json
uses: sergeysova/jq-action@v2
id: node_version
with:
cmd: jq .engines.node package.json -r | sed -e 's/"//g' | sed -e 's/>=//g'
- name: Use Node.js
uses: actions/setup-node@v4
with:
node-version: '${{ steps.node_version.outputs.value }}'
- name: Use Yarn
run: corepack enable
- name: Install deps
run: yarn
- name: Generate Docs
run: yarn run docs/generate
- uses: stefanzweifel/git-auto-commit-action@v5
with:
commit_message: "[skip ci] docs: automated update to docs\n\nskip-checks: true"
file_pattern: 'docs/**'

unit_tests_linux:
name: Verify PR - Tests (Linux)
runs-on: ubuntu-latest
Expand Down
30 changes: 30 additions & 0 deletions .github/workflows/verify-commits.yml
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,36 @@ permissions:
contents: read

jobs:
generate_docs:
name: Generate Docs
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
token: ${{ secrets.DOCUMENTATION_GITHUB_TOKEN }}
ref: ${{ github.head_ref }}
- name: Extract node version from package.json
uses: sergeysova/jq-action@v2
id: node_version
with:
cmd: jq .engines.node package.json -r | sed -e 's/"//g' | sed -e 's/>=//g'
- name: Use Node.js
uses: actions/setup-node@v4
with:
node-version: '${{ steps.node_version.outputs.value }}'
- name: Use Yarn
run: corepack enable
- name: Install deps
run: yarn
- name: Generate Docs
run: yarn run docs/generate
- name: Ignore mode changes
run: git config --global core.fileMode false
- uses: stefanzweifel/git-auto-commit-action@v5
with:
commit_message: "[skip ci] docs: automated update to docs\n\nskip-checks: true"
file_pattern: 'docs/**'

unit_tests_linux:
name: Verify Tests (Linux)
runs-on: ubuntu-latest
Expand Down
4 changes: 1 addition & 3 deletions .husky/prepare-commit-msg
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,4 @@ if [ -d "$GIT_DIRECTORY"/rebase-apply ]; then
exit 0
fi

if [ -d /dev/tty ]; then
exec </dev/tty && yarn dlx git-cz --hook || true
fi
exec </dev/tty && yarn dlx git-cz --hook || true
2 changes: 1 addition & 1 deletion changelog.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ module.exports = {
'issues',
'lerna',
],
scopes: ['api', 'ui', 'extension', 'updater', 'misc'],
scopes: ['api', 'ui', 'ext', 'updater', 'misc'],
types: {
chore: {
description: 'Build process or auxiliary tool changes',
Expand Down
Empty file modified docs/README.md
100644 → 100755
Empty file.
Empty file modified docs/documents/CONTRIBUTING.md
100644 → 100755
Empty file.
Empty file modified docs/documents/SECURITY.md
100644 → 100755
Empty file.
Empty file modified docs/documents/api/data-model.md
100644 → 100755
Empty file.
Empty file modified docs/documents/api/mqtt.md
100644 → 100755
Empty file.
Empty file modified docs/documents/contributing/conventions.md
100644 → 100755
Empty file.
Empty file.
Empty file.
Empty file modified docs/documents/contributing/development-environment/index.md
100644 → 100755
Empty file.
Empty file.
Empty file modified docs/documents/contributing/rfc.md
100644 → 100755
Empty file.
Empty file modified docs/documents/design/README.md
100644 → 100755
Empty file.
Empty file modified docs/documents/guides/setup.md
100644 → 100755
Empty file.
Empty file modified docs/types.entities/README.md
100644 → 100755
Empty file.
2 changes: 1 addition & 1 deletion docs/types.entities/type-aliases/CompletionStatus.md
100644 → 100755
Original file line number Diff line number Diff line change
Expand Up @@ -26,4 +26,4 @@ Completion statuses are used to describe a player's progress in a game.

## Defined in

[types.entities.ts:184](https://github.com/andrew-codes/playnite-web/blob/b159d1f96feee4620c5fbc9157a5493b48d2f672/apps/playnite-web/src/server/data/types.entities.ts#L184)
[types.entities.ts:184](https://github.com/andrew-codes/playnite-web/blob/main/apps/playnite-web/src/server/data/types.entities.ts#L184)
2 changes: 1 addition & 1 deletion docs/types.entities/type-aliases/Entity.md
100644 → 100755
Original file line number Diff line number Diff line change
Expand Up @@ -12,4 +12,4 @@ Supported entities.

## Defined in

[types.entities.ts:96](https://github.com/andrew-codes/playnite-web/blob/b159d1f96feee4620c5fbc9157a5493b48d2f672/apps/playnite-web/src/server/data/types.entities.ts#L96)
[types.entities.ts:96](https://github.com/andrew-codes/playnite-web/blob/main/apps/playnite-web/src/server/data/types.entities.ts#L96)
2 changes: 1 addition & 1 deletion docs/types.entities/type-aliases/Game.md
100644 → 100755
Original file line number Diff line number Diff line change
Expand Up @@ -41,4 +41,4 @@ A game may have multiple releases across different platforms and sources.

## Defined in

[types.entities.ts:220](https://github.com/andrew-codes/playnite-web/blob/b159d1f96feee4620c5fbc9157a5493b48d2f672/apps/playnite-web/src/server/data/types.entities.ts#L220)
[types.entities.ts:220](https://github.com/andrew-codes/playnite-web/blob/main/apps/playnite-web/src/server/data/types.entities.ts#L220)
2 changes: 1 addition & 1 deletion docs/types.entities/type-aliases/GameAsset.md
100644 → 100755
Original file line number Diff line number Diff line change
Expand Up @@ -34,4 +34,4 @@ Game assets are used to associate images with entities.

## Defined in

[types.entities.ts:327](https://github.com/andrew-codes/playnite-web/blob/b159d1f96feee4620c5fbc9157a5493b48d2f672/apps/playnite-web/src/server/data/types.entities.ts#L327)
[types.entities.ts:327](https://github.com/andrew-codes/playnite-web/blob/main/apps/playnite-web/src/server/data/types.entities.ts#L327)
2 changes: 1 addition & 1 deletion docs/types.entities/type-aliases/GameAssetType.md
100644 → 100755
Original file line number Diff line number Diff line change
Expand Up @@ -22,4 +22,4 @@ Game asset types represent the types of game assets that can be associated with

## Defined in

[types.entities.ts:317](https://github.com/andrew-codes/playnite-web/blob/b159d1f96feee4620c5fbc9157a5493b48d2f672/apps/playnite-web/src/server/data/types.entities.ts#L317)
[types.entities.ts:317](https://github.com/andrew-codes/playnite-web/blob/main/apps/playnite-web/src/server/data/types.entities.ts#L317)
2 changes: 1 addition & 1 deletion docs/types.entities/type-aliases/GameFeature.md
100644 → 100755
Original file line number Diff line number Diff line change
Expand Up @@ -26,4 +26,4 @@ Features are used to describe a game's characteristics.

## Defined in

[types.entities.ts:162](https://github.com/andrew-codes/playnite-web/blob/b159d1f96feee4620c5fbc9157a5493b48d2f672/apps/playnite-web/src/server/data/types.entities.ts#L162)
[types.entities.ts:162](https://github.com/andrew-codes/playnite-web/blob/main/apps/playnite-web/src/server/data/types.entities.ts#L162)
2 changes: 1 addition & 1 deletion docs/types.entities/type-aliases/GameSource.md
100644 → 100755
Original file line number Diff line number Diff line change
Expand Up @@ -26,4 +26,4 @@ Sources are used to describe where a game was obtained.

## Defined in

[types.entities.ts:206](https://github.com/andrew-codes/playnite-web/blob/b159d1f96feee4620c5fbc9157a5493b48d2f672/apps/playnite-web/src/server/data/types.entities.ts#L206)
[types.entities.ts:206](https://github.com/andrew-codes/playnite-web/blob/main/apps/playnite-web/src/server/data/types.entities.ts#L206)
2 changes: 1 addition & 1 deletion docs/types.entities/type-aliases/Genre.md
100644 → 100755
Original file line number Diff line number Diff line change
Expand Up @@ -26,4 +26,4 @@ Genres are used to categorize games by their game play characteristics.

## Defined in

[types.entities.ts:173](https://github.com/andrew-codes/playnite-web/blob/b159d1f96feee4620c5fbc9157a5493b48d2f672/apps/playnite-web/src/server/data/types.entities.ts#L173)
[types.entities.ts:173](https://github.com/andrew-codes/playnite-web/blob/main/apps/playnite-web/src/server/data/types.entities.ts#L173)
2 changes: 1 addition & 1 deletion docs/types.entities/type-aliases/Identifiable.md
100644 → 100755
Original file line number Diff line number Diff line change
Expand Up @@ -18,4 +18,4 @@ Foundation of all data entities; all data entities have an ID.
## Defined in

[types.entities.ts:4](https://github.com/andrew-codes/playnite-web/blob/b159d1f96feee4620c5fbc9157a5493b48d2f672/apps/playnite-web/src/server/data/types.entities.ts#L4)
[types.entities.ts:4](https://github.com/andrew-codes/playnite-web/blob/main/apps/playnite-web/src/server/data/types.entities.ts#L4)
2 changes: 1 addition & 1 deletion docs/types.entities/type-aliases/Platform.md
100644 → 100755
Original file line number Diff line number Diff line change
Expand Up @@ -60,4 +60,4 @@ Platforms are used to categorize games by the system they are played on. Note a

## Defined in

[types.entities.ts:116](https://github.com/andrew-codes/playnite-web/blob/b159d1f96feee4620c5fbc9157a5493b48d2f672/apps/playnite-web/src/server/data/types.entities.ts#L116)
[types.entities.ts:116](https://github.com/andrew-codes/playnite-web/blob/main/apps/playnite-web/src/server/data/types.entities.ts#L116)
2 changes: 1 addition & 1 deletion docs/types.entities/type-aliases/Playlist.md
100644 → 100755
Original file line number Diff line number Diff line change
Expand Up @@ -36,4 +36,4 @@ Playlists are used to group games together for easy access. A playlist consists

## Defined in

[types.entities.ts:299](https://github.com/andrew-codes/playnite-web/blob/b159d1f96feee4620c5fbc9157a5493b48d2f672/apps/playnite-web/src/server/data/types.entities.ts#L299)
[types.entities.ts:299](https://github.com/andrew-codes/playnite-web/blob/main/apps/playnite-web/src/server/data/types.entities.ts#L299)
2 changes: 1 addition & 1 deletion docs/types.entities/type-aliases/Release.md
100644 → 100755
Original file line number Diff line number Diff line change
Expand Up @@ -152,4 +152,4 @@ A release is a specific version of a game that is available on a platform and so

## Defined in

[types.entities.ts:255](https://github.com/andrew-codes/playnite-web/blob/b159d1f96feee4620c5fbc9157a5493b48d2f672/apps/playnite-web/src/server/data/types.entities.ts#L255)
[types.entities.ts:255](https://github.com/andrew-codes/playnite-web/blob/main/apps/playnite-web/src/server/data/types.entities.ts#L255)
2 changes: 1 addition & 1 deletion docs/types.entities/type-aliases/RunState.md
100644 → 100755
Original file line number Diff line number Diff line change
Expand Up @@ -22,4 +22,4 @@ Run states are used to describe the current state of a game's process.

## Defined in

[types.entities.ts:247](https://github.com/andrew-codes/playnite-web/blob/b159d1f96feee4620c5fbc9157a5493b48d2f672/apps/playnite-web/src/server/data/types.entities.ts#L247)
[types.entities.ts:247](https://github.com/andrew-codes/playnite-web/blob/main/apps/playnite-web/src/server/data/types.entities.ts#L247)
2 changes: 1 addition & 1 deletion docs/types.entities/type-aliases/Series.md
100644 → 100755
Original file line number Diff line number Diff line change
Expand Up @@ -32,4 +32,4 @@ The "Assassin's Creed" series would include all games in the "Assassin's Creed"

## Defined in

[types.entities.ts:151](https://github.com/andrew-codes/playnite-web/blob/b159d1f96feee4620c5fbc9157a5493b48d2f672/apps/playnite-web/src/server/data/types.entities.ts#L151)
[types.entities.ts:151](https://github.com/andrew-codes/playnite-web/blob/main/apps/playnite-web/src/server/data/types.entities.ts#L151)
2 changes: 1 addition & 1 deletion docs/types.entities/type-aliases/Tag.md
100644 → 100755
Original file line number Diff line number Diff line change
Expand Up @@ -26,4 +26,4 @@ Tags are used to categorize games by their characteristics.

## Defined in

[types.entities.ts:195](https://github.com/andrew-codes/playnite-web/blob/b159d1f96feee4620c5fbc9157a5493b48d2f672/apps/playnite-web/src/server/data/types.entities.ts#L195)
[types.entities.ts:195](https://github.com/andrew-codes/playnite-web/blob/main/apps/playnite-web/src/server/data/types.entities.ts#L195)
2 changes: 1 addition & 1 deletion docs/types.entities/type-aliases/User.md
100644 → 100755
Original file line number Diff line number Diff line change
Expand Up @@ -34,4 +34,4 @@ Users are used to authenticate and authorize access to the application.

## Defined in

[types.entities.ts:340](https://github.com/andrew-codes/playnite-web/blob/b159d1f96feee4620c5fbc9157a5493b48d2f672/apps/playnite-web/src/server/data/types.entities.ts#L340)
[types.entities.ts:340](https://github.com/andrew-codes/playnite-web/blob/main/apps/playnite-web/src/server/data/types.entities.ts#L340)
2 changes: 1 addition & 1 deletion docs/types.entities/variables/runStates.md
100644 → 100755
Original file line number Diff line number Diff line change
Expand Up @@ -12,4 +12,4 @@ Possible run state values.

## Defined in

[types.entities.ts:231](https://github.com/andrew-codes/playnite-web/blob/b159d1f96feee4620c5fbc9157a5493b48d2f672/apps/playnite-web/src/server/data/types.entities.ts#L231)
[types.entities.ts:231](https://github.com/andrew-codes/playnite-web/blob/main/apps/playnite-web/src/server/data/types.entities.ts#L231)
3 changes: 2 additions & 1 deletion typedoc.json
Original file line number Diff line number Diff line change
Expand Up @@ -11,5 +11,6 @@
],
"exclude": [],
"readme": "none",
"out": "./docs"
"out": "./docs",
"gitRevision": "main"
}

0 comments on commit c120d88

Please sign in to comment.