Skip to content

Commit

Permalink
chore: automate-docs
Browse files Browse the repository at this point in the history
fix doc generation commands
  • Loading branch information
ryanbas21 committed Dec 10, 2024
1 parent 4f76d1d commit 5e0abc4
Show file tree
Hide file tree
Showing 19 changed files with 228 additions and 8 deletions.
1 change: 1 addition & 0 deletions .eslintignore
Original file line number Diff line number Diff line change
@@ -1,2 +1,3 @@
node_modules
pnpm-lock.yaml
packages/*/docs
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,7 @@ todos/*
users/*
#Project Docs
docs/packages/javascript-sdk
packages/*/docs
**/playwright-report
**/playwright/.cache

Expand Down
1 change: 1 addition & 0 deletions packages/davinci-client/.eslintignore
Original file line number Diff line number Diff line change
Expand Up @@ -6,3 +6,4 @@ LICENSE
.bin
dist
.eslintignore
docs
2 changes: 1 addition & 1 deletion packages/davinci-client/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@forgerock/davinci-client",
"version": "0.0.1-davinci.6",
"version": "0.0.1-davinci.8",
"main": "./dist/index.js",
"module": "./dist/index.js",
"typings": "./dist/index.d.ts",
Expand Down
3 changes: 3 additions & 0 deletions packages/davinci-client/project.json
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,9 @@
"projectType": "library",
"tags": ["scope:package"],
"targets": {
"docs": {
"command": "pnpm typedoc --options {projectRoot}/typedoc.json"
},
"build": {
"inputs": [
"default",
Expand Down
68 changes: 68 additions & 0 deletions packages/davinci-client/typedoc.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
{
"entryPointStrategy": "expand",
"entryPoints": ["./src/"],
"tsconfig": "tsconfig.lib.json",
"compilerOptions": {},
"exclude": [
"**/*.(spec|test|e2e).ts",
"**/*.mock.*",
"**/*.data.*",
"docs/**",
"tests/**",
"specs/**",
"spec/**",
"test/**"
],
"externalPattern": ["**/node_modules/**"],
"excludeExternals": true,
"excludeInternal": false,
"excludePrivate": false,
"excludeProtected": false,
"excludeNotDocumented": false,
"externalSymbolLinkMappings": {},
"out": "./docs",
"emit": "docs",
"theme": "hierarchy",
"name": "davinci-client",
"includeVersion": true,
"readme": "./README.md",
"disableSources": false,
"excludeTags": [],
"cname": "",
"sourceLinkTemplate": "",
"gitRevision": "master",
"gitRemote": "origin",
"lang": "en",
"githubPages": true,
"hideGenerator": true,
"searchInComments": false,
"cleanOutputDir": true,
"titleLink": "",
"navigationLinks": {},
"sidebarLinks": {},
"commentStyle": "all",
"categorizeByGroup": true,
"defaultCategory": "Other",
"categoryOrder": [],
"sort": ["visibility", "required-first", "source-order"],
"visibilityFilters": {
"protected": true,
"private": true,
"inherited": true,
"external": true
},
"searchCategoryBoosts": {},
"searchGroupBoosts": {},
"preserveWatchOutput": false,
"skipErrorChecking": false,
"validation": {
"notExported": true,
"invalidLink": true,
"notDocumented": true
},
"requiredToBeDocumented": [],
"treatWarningsAsErrors": false,
"intentionallyNotExported": [],
"logLevel": "Verbose",
"plugin": ["typedoc-plugin-rename-defaults", "typedoc-theme-hierarchy"]
}
1 change: 1 addition & 0 deletions packages/device-client/.eslintignore
Original file line number Diff line number Diff line change
Expand Up @@ -6,3 +6,4 @@ LICENSE
.bin
dist
.eslintignore
docs
3 changes: 3 additions & 0 deletions packages/device-client/project.json
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,9 @@
"projectType": "library",
"tags": ["scope:package"],
"targets": {
"docs": {
"command": "pnpm typedoc --options {projectRoot}/typedoc.json"
},
"build": {
"outputs": ["{projectRoot}/{options.outDir}", "{projectRoot}/dist"],
"options": {
Expand Down
4 changes: 2 additions & 2 deletions packages/device-client/tsconfig.json
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
{
"extends": "../../tsconfig.base.json",
"compilerOptions": {
"module": "NodeNext",
"moduleResolution": "NodeNext",
"module": "ES2020",
"moduleResolution": "Bundler",
"forceConsistentCasingInFileNames": true,
"strict": true,
"noImplicitOverride": true,
Expand Down
68 changes: 68 additions & 0 deletions packages/device-client/typedoc.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
{
"entryPointStrategy": "expand",
"entryPoints": ["./src/"],
"tsconfig": "tsconfig.lib.json",
"compilerOptions": {},
"exclude": [
"**/*.(spec|test|e2e).ts",
"**/*.mock.*",
"**/*.data.*",
"docs/**",
"tests/**",
"specs/**",
"spec/**",
"test/**"
],
"externalPattern": ["**/node_modules/**"],
"excludeExternals": true,
"excludeInternal": false,
"excludePrivate": false,
"excludeProtected": false,
"excludeNotDocumented": false,
"externalSymbolLinkMappings": {},
"out": "./docs",
"emit": "docs",
"theme": "hierarchy",
"name": "device-client",
"includeVersion": true,
"readme": "./README.md",
"disableSources": false,
"excludeTags": [],
"cname": "",
"sourceLinkTemplate": "",
"gitRevision": "master",
"gitRemote": "origin",
"lang": "en",
"githubPages": true,
"hideGenerator": true,
"searchInComments": false,
"cleanOutputDir": true,
"titleLink": "",
"navigationLinks": {},
"sidebarLinks": {},
"commentStyle": "all",
"categorizeByGroup": true,
"defaultCategory": "Other",
"categoryOrder": [],
"sort": ["visibility", "required-first", "source-order"],
"visibilityFilters": {
"protected": true,
"private": true,
"inherited": true,
"external": true
},
"searchCategoryBoosts": {},
"searchGroupBoosts": {},
"preserveWatchOutput": false,
"skipErrorChecking": false,
"validation": {
"notExported": true,
"invalidLink": true,
"notDocumented": true
},
"requiredToBeDocumented": [],
"treatWarningsAsErrors": false,
"intentionallyNotExported": [],
"logLevel": "Verbose",
"plugin": ["typedoc-plugin-rename-defaults", "typedoc-theme-hierarchy"]
}
1 change: 1 addition & 0 deletions packages/javascript-sdk/.eslintignore
Original file line number Diff line number Diff line change
Expand Up @@ -5,3 +5,4 @@ LICENSE
.env*
.bin
dist
docs
2 changes: 1 addition & 1 deletion packages/javascript-sdk/project.json
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"tags": ["scope:sdk"],
"targets": {
"docs": {
"command": "npx typedoc --options packages/javascript-sdk/typedoc.json"
"command": "pnpm typedoc --options {projectRoot}/typedoc.json"
},
"build": {
"inputs": [
Expand Down
2 changes: 1 addition & 1 deletion packages/javascript-sdk/typedoc.json
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@
"excludeProtected": false,
"excludeNotDocumented": false,
"externalSymbolLinkMappings": {},
"out": "../../docs/packages/javascript-sdk",
"out": "./docs",
"emit": "docs",
"theme": "hierarchy",
"name": "javascript-sdk",
Expand Down
3 changes: 2 additions & 1 deletion packages/ping-protect/.eslintignore
Original file line number Diff line number Diff line change
Expand Up @@ -6,4 +6,5 @@ LICENSE
.bin
dist
src/lib/ping-signals-sdk.js
.eslintignore
.eslintignore
docs
2 changes: 1 addition & 1 deletion packages/ping-protect/project.json
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"tags": ["scope:package"],
"targets": {
"docs": {
"command": "npx typedoc --options ./packages/ping-protect/typedoc.json"
"command": "pnpm typedoc --options {projectRoot}/typedoc.json"
},
"build": {
"inputs": [
Expand Down
2 changes: 1 addition & 1 deletion packages/ping-protect/typedoc.json
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@
"excludeProtected": false,
"excludeNotDocumented": false,
"externalSymbolLinkMappings": {},
"out": "../../docs/packages/ping-protect",
"out": "./docs",
"emit": "docs",
"theme": "hierarchy",
"name": "ping-protect",
Expand Down
1 change: 1 addition & 0 deletions packages/token-vault/.eslintignore
Original file line number Diff line number Diff line change
Expand Up @@ -6,3 +6,4 @@ LICENSE
.env*
.bin
dist
docs
3 changes: 3 additions & 0 deletions packages/token-vault/project.json
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,9 @@
"projectType": "library",
"tags": ["scope:package"],
"targets": {
"docs": {
"command": "pnpm typedoc --options {projectRoot}/typedoc.json"
},
"build": {
"dependsOn": ["javascript-sdk:build"],
"inputs": [
Expand Down
68 changes: 68 additions & 0 deletions packages/token-vault/typedoc.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
{
"entryPointStrategy": "expand",
"entryPoints": ["./src/"],
"tsconfig": "tsconfig.lib.json",
"compilerOptions": {},
"exclude": [
"**/*.(spec|test|e2e).ts",
"**/*.mock.*",
"**/*.data.*",
"docs/**",
"tests/**",
"specs/**",
"spec/**",
"test/**"
],
"externalPattern": ["**/node_modules/**"],
"excludeExternals": true,
"excludeInternal": false,
"excludePrivate": false,
"excludeProtected": false,
"excludeNotDocumented": false,
"externalSymbolLinkMappings": {},
"out": "./docs",
"emit": "docs",
"theme": "hierarchy",
"name": "token-vault",
"includeVersion": true,
"readme": "./README.md",
"disableSources": false,
"excludeTags": [],
"cname": "",
"sourceLinkTemplate": "",
"gitRevision": "master",
"gitRemote": "origin",
"lang": "en",
"githubPages": true,
"hideGenerator": true,
"searchInComments": false,
"cleanOutputDir": true,
"titleLink": "",
"navigationLinks": {},
"sidebarLinks": {},
"commentStyle": "all",
"categorizeByGroup": true,
"defaultCategory": "Other",
"categoryOrder": [],
"sort": ["visibility", "required-first", "source-order"],
"visibilityFilters": {
"protected": true,
"private": true,
"inherited": true,
"external": true
},
"searchCategoryBoosts": {},
"searchGroupBoosts": {},
"preserveWatchOutput": false,
"skipErrorChecking": false,
"validation": {
"notExported": true,
"invalidLink": true,
"notDocumented": true
},
"requiredToBeDocumented": [],
"treatWarningsAsErrors": false,
"intentionallyNotExported": [],
"logLevel": "Verbose",
"plugin": ["typedoc-plugin-rename-defaults", "typedoc-theme-hierarchy"]
}

0 comments on commit 5e0abc4

Please sign in to comment.