Browse Source

docs : refactor - naming convention

Signed-off-by: Naveen MR <oof1lab@gmail.com>
pull/1050/head
Naveen MR 3 years ago
parent
commit
ec04d746bb
  1. 2
      packages/noco-docs/content/en/FAQs.md
  2. 8
      packages/noco-docs/content/en/developer-resources/1000_accessing-apis.md
  3. 2
      packages/noco-docs/content/en/developer-resources/1010_rest-apis.md
  4. 2
      packages/noco-docs/content/en/developer-resources/1020_graphql-apis.md
  5. 2
      packages/noco-docs/content/en/developer-resources/1030_webhooks.md
  6. 2
      packages/noco-docs/content/en/developer-resources/1040_api-tokens.md
  7. 41
      packages/noco-docs/content/en/engineering/2000_publish.md
  8. 2
      packages/noco-docs/content/en/getting-started/10_installation.md
  9. 2
      packages/noco-docs/content/en/getting-started/20_upgrading.md
  10. 2
      packages/noco-docs/content/en/getting-started/30_demos.md
  11. 2
      packages/noco-docs/content/en/setup-and-usages/500_dashboard.md
  12. 2
      packages/noco-docs/content/en/setup-and-usages/510_table-operations.md
  13. 2
      packages/noco-docs/content/en/setup-and-usages/520_column-types.md
  14. 2
      packages/noco-docs/content/en/setup-and-usages/530_column-operations.md
  15. 2
      packages/noco-docs/content/en/setup-and-usages/540_link-to-another-record.md
  16. 2
      packages/noco-docs/content/en/setup-and-usages/550_lookup.md
  17. 2
      packages/noco-docs/content/en/setup-and-usages/560_rollup.md
  18. 2
      packages/noco-docs/content/en/setup-and-usages/570_formulas.md
  19. 2
      packages/noco-docs/content/en/setup-and-usages/590_audit.md
  20. 2
      packages/noco-docs/content/en/setup-and-usages/600_meta-management.md
  21. 2
      packages/noco-docs/content/en/setup-and-usages/610_sync-schema.md
  22. 6
      packages/noco-docs/content/en/setup-and-usages/620_team-and-auth.md
  23. 43
      packages/noco-docs/content/en/setup-and-usages/publish.md
  24. 16844
      packages/noco-docs/package-lock.json
  25. 2
      packages/noco-docs/package.json

2
packages/noco-docs/content/en/FAQs.md

@ -1,7 +1,7 @@
--- ---
title: 'FAQs' title: 'FAQs'
description: 'FAQs' description: 'FAQs'
position: 10000 position: 1000000
category: 'FAQ' category: 'FAQ'
fullscreen: true fullscreen: true
menuTitle: 'FAQs' menuTitle: 'FAQs'

8
packages/noco-docs/content/en/developer-resources/accessing-apis.md → packages/noco-docs/content/en/developer-resources/1000_accessing-apis.md

@ -1,9 +1,9 @@
--- ---
title: 'How to access APIs ?' title: 'Accessing APIs'
description: 'How to access APIs ?' description: 'Accessing APIs'
position: 100 position: 1000
category: 'Developer Resources' category: 'Developer Resources'
menuTitle: 'How to access APIs ?' menuTitle: 'Accessing APIs'
--- ---
## REST APIs ## REST APIs

2
packages/noco-docs/content/en/developer-resources/rest-apis.md → packages/noco-docs/content/en/developer-resources/1010_rest-apis.md

@ -1,6 +1,6 @@
--- ---
title: 'REST APIs' title: 'REST APIs'
position: 200 position: 1010
category: 'Developer Resources' category: 'Developer Resources'
menuTitle: 'REST APIs' menuTitle: 'REST APIs'
--- ---

2
packages/noco-docs/content/en/developer-resources/graphql-apis.md → packages/noco-docs/content/en/developer-resources/1020_graphql-apis.md

@ -1,6 +1,6 @@
--- ---
title: 'GraphQL APIs' title: 'GraphQL APIs'
position: 300 position: 1020
category: 'Developer Resources' category: 'Developer Resources'
menuTitle: 'GraphQL APIs' menuTitle: 'GraphQL APIs'
--- ---

2
packages/noco-docs/content/en/developer-resources/webhooks.md → packages/noco-docs/content/en/developer-resources/1030_webhooks.md

@ -1,7 +1,7 @@
--- ---
title: 'Webhooks' title: 'Webhooks'
description: 'Webhooks' description: 'Webhooks'
position: 400 position: 1030
category: 'Developer Resources' category: 'Developer Resources'
menuTitle: 'Webhooks' menuTitle: 'Webhooks'
--- ---

2
packages/noco-docs/content/en/developer-resources/api-tokens.md → packages/noco-docs/content/en/developer-resources/1040_api-tokens.md

@ -1,7 +1,7 @@
--- ---
title: 'API Tokens' title: 'API Tokens'
description: 'API Tokens' description: 'API Tokens'
position: 500 position: 1040
category: 'Developer Resources' category: 'Developer Resources'
menuTitle: 'API Tokens' menuTitle: 'API Tokens'
--- ---

41
packages/noco-docs/content/en/engineering/2000_publish.md

@ -0,0 +1,41 @@
---
title: "Making a release"
description: "Making a release"
position: 2000
category: "Engineering"
menuTitle: "Making a release"
---
> This is exclusive to NocoDB team members only
## 1. Merge ```develop``` to ```master```
- When several features are included in develop branch and they are ready to be released, make a PR from `develop` branch to `master` branch. At least one NocoDB team member approval is required.
## 2. Publish frontend
- Navigate to `packages/nc-gui` and execute following command.
```bash
npm run build:copy:jsdeliver
```
## 3. Install frontend
- Install the latest published version of `nc-lib-gui` in `packages/nocodb`, package version can be extracted from result of step 1 or copy it from `packages/nc-lib-gui/package.json`. While installing, add `-E` to install exact version of the package.
- Example: for latest published version `0.84.8`
```bash
npm i -E nc-lib-gui@0.84.8
```
## 4. Publish backend
- Bump package version in `packages/nocodb/package.json` file.
- Publish the npm package by running following npm command in `packages/nocodb` folder.
```
npm run obfuscate:build:publish
```
## 5. Prepare release notes
- Populate release note by running following github action (on `master` branch) - `Release : Draft Notes`. While running the action you have to provide 2 inputs:
- **Tag** : Provide current package version
- **Previous Tag** : Provide previously released tag version
## 6. Publish docker & release
- Publish docker image by running `Release : Docker` action in github (on `master` branch), where you have to provide the package version/tag.
- Update the populated release (remove issues which is not related to release) draft and publish. In release note you can use `Auto-generate release notes` button to populate release content from commits & PR.

2
packages/noco-docs/content/en/getting-started/installation.md → packages/noco-docs/content/en/getting-started/10_installation.md

@ -1,7 +1,7 @@
--- ---
title: 'Installation' title: 'Installation'
description: 'Simple installation - takes about three minutes!' description: 'Simple installation - takes about three minutes!'
position: 1 position: 10
category: 'Getting started' category: 'Getting started'
menuTitle: 'Installation' menuTitle: 'Installation'
link: https://codesandbox.io/embed/vigorous-firefly-80kq5?hidenavigation=1&theme=dark link: https://codesandbox.io/embed/vigorous-firefly-80kq5?hidenavigation=1&theme=dark

2
packages/noco-docs/content/en/getting-started/upgrading.md → packages/noco-docs/content/en/getting-started/20_upgrading.md

@ -1,7 +1,7 @@
--- ---
title: 'Upgrading' title: 'Upgrading'
description: 'Upgrading NocoDB : Docker, npm, Heroku!' description: 'Upgrading NocoDB : Docker, npm, Heroku!'
position: 2 position: 20
category: 'Getting started' category: 'Getting started'
menuTitle: 'Upgrading' menuTitle: 'Upgrading'
link: https://codesandbox.io/embed/vigorous-firefly-80kq5?hidenavigation=1&theme=dark link: https://codesandbox.io/embed/vigorous-firefly-80kq5?hidenavigation=1&theme=dark

2
packages/noco-docs/content/en/getting-started/demos.md → packages/noco-docs/content/en/getting-started/30_demos.md

@ -1,7 +1,7 @@
--- ---
title: 'Demos' title: 'Demos'
description: 'Demos' description: 'Demos'
position: 3 position: 30
category: 'Getting started' category: 'Getting started'
fullscreen: true fullscreen: true
menuTitle: 'Demos' menuTitle: 'Demos'

2
packages/noco-docs/content/en/setup-and-usages/dashboard.md → packages/noco-docs/content/en/setup-and-usages/500_dashboard.md

@ -1,7 +1,7 @@
--- ---
title: 'Dashboard' title: 'Dashboard'
description: 'Dashboard' description: 'Dashboard'
position: 10 position: 500
category: 'Usage' category: 'Usage'
menuTitle: 'Dashboard' menuTitle: 'Dashboard'
--- ---

2
packages/noco-docs/content/en/setup-and-usages/tables.md → packages/noco-docs/content/en/setup-and-usages/510_table-operations.md

@ -1,7 +1,7 @@
--- ---
title: "Table Operations" title: "Table Operations"
description: "Table Operations" description: "Table Operations"
position: 20 position: 510
category: "Usage" category: "Usage"
menuTitle: "Table Operations" menuTitle: "Table Operations"
--- ---

2
packages/noco-docs/content/en/setup-and-usages/column-types.md → packages/noco-docs/content/en/setup-and-usages/520_column-types.md

@ -1,7 +1,7 @@
--- ---
title: 'Column Types' title: 'Column Types'
description: 'Column Types' description: 'Column Types'
position: 30 position: 520
category: 'Usage' category: 'Usage'
menuTitle: 'Column Types' menuTitle: 'Column Types'
--- ---

2
packages/noco-docs/content/en/setup-and-usages/column-operations.md → packages/noco-docs/content/en/setup-and-usages/530_column-operations.md

@ -1,7 +1,7 @@
--- ---
title: "Column Operations" title: "Column Operations"
description: "Column Operations" description: "Column Operations"
position: 35 position: 530
category: "Usage" category: "Usage"
menuTitle: "Column Operations" menuTitle: "Column Operations"
--- ---

2
packages/noco-docs/content/en/setup-and-usages/link-to-another-record.md → packages/noco-docs/content/en/setup-and-usages/540_link-to-another-record.md

@ -1,7 +1,7 @@
--- ---
title: "Link To Another Record" title: "Link To Another Record"
description: "Link To Another Record" description: "Link To Another Record"
position: 39 position: 540
category: "Usage" category: "Usage"
menuTitle: "Link To Another Record" menuTitle: "Link To Another Record"
--- ---

2
packages/noco-docs/content/en/setup-and-usages/lookup.md → packages/noco-docs/content/en/setup-and-usages/550_lookup.md

@ -1,7 +1,7 @@
--- ---
title: "Lookup" title: "Lookup"
description: "Lookup" description: "Lookup"
position: 41 position: 550
category: "Usage" category: "Usage"
menuTitle: "Lookup" menuTitle: "Lookup"
--- ---

2
packages/noco-docs/content/en/setup-and-usages/rollup.md → packages/noco-docs/content/en/setup-and-usages/560_rollup.md

@ -1,7 +1,7 @@
--- ---
title: "Rollup" title: "Rollup"
description: "Rollup" description: "Rollup"
position: 42 position: 560
category: "Usage" category: "Usage"
menuTitle: "Rollup" menuTitle: "Rollup"
--- ---

2
packages/noco-docs/content/en/setup-and-usages/formulas.md → packages/noco-docs/content/en/setup-and-usages/570_formulas.md

@ -1,7 +1,7 @@
--- ---
title: "Formulas" title: "Formulas"
description: "Formulas" description: "Formulas"
position: 43 position: 580
category: "Usage" category: "Usage"
menuTitle: "Formulas" menuTitle: "Formulas"
--- ---

2
packages/noco-docs/content/en/setup-and-usages/audit.md → packages/noco-docs/content/en/setup-and-usages/590_audit.md

@ -1,7 +1,7 @@
--- ---
title: 'Audit' title: 'Audit'
description: 'Audit log' description: 'Audit log'
position: 50 position: 590
category: 'Usage' category: 'Usage'
menuTitle: 'Audit' menuTitle: 'Audit'
--- ---

2
packages/noco-docs/content/en/setup-and-usages/meta-management.md → packages/noco-docs/content/en/setup-and-usages/600_meta-management.md

@ -1,7 +1,7 @@
--- ---
title: 'Metadata' title: 'Metadata'
description: 'Metadata' description: 'Metadata'
position: 60 position: 600
category: 'Usage' category: 'Usage'
menuTitle: 'Metadata' menuTitle: 'Metadata'
--- ---

2
packages/noco-docs/content/en/setup-and-usages/sync-schema.md → packages/noco-docs/content/en/setup-and-usages/610_sync-schema.md

@ -1,7 +1,7 @@
--- ---
title: 'Sync Schema' title: 'Sync Schema'
description: 'Schema changes made to database from outside nocodb GUI can be synced' description: 'Schema changes made to database from outside nocodb GUI can be synced'
position: 70 position: 610
category: 'Usage' category: 'Usage'
menuTitle: 'Sync Schema' menuTitle: 'Sync Schema'
--- ---

6
packages/noco-docs/content/en/setup-and-usages/user-management.md → packages/noco-docs/content/en/setup-and-usages/620_team-and-auth.md

@ -1,9 +1,9 @@
--- ---
title: 'User Management - Team & Auth Roles & Permissions' title: 'Team & Auth'
description: 'Breakdown of roles & permissions for team user management' description: 'Breakdown of roles & permissions for team user management'
position: 44 position: 620
category: 'Usage' category: 'Usage'
menuTitle: 'User Management - Team & Auth Roles & Permissions' menuTitle: 'Team & Auth'
--- ---

43
packages/noco-docs/content/en/setup-and-usages/publish.md

@ -1,43 +0,0 @@
---
title: "Publishing Packages"
description: "Publishing Packages"
position: 100
category: "Usage"
menuTitle: "Publishing Packages"
---
> This is exclusive to NocoDB team members only
## Steps
1. When several features are included in develop branch and they are ready to be released, make a PR from `deveop` branach to `master` branch. At least one NocoDB team member approval is required.
2. Navigate to `packages/nc-gui` and execute following command.
```bash
npm run build:copy:jsdeliver
```
3. Install the latest published version of `nc-lig-gui` in `packages/nocodb`, package version can be extracted from result of step 1 or copy it from `packages/nc-lib-gui/package.json`. While installing, add `-E` to install exact version of the package.
Example: latest published version `0.84.8`
```bash
npm i -E nc-lib-gui@0.84.8
```
4. Update package version in `packages/nocodb/package.json` file.
5. Publish the npm package by running following npm command in `packages/nocodb` folder.
```
npm run obfuscate:build:publish
```
6. Populate release note by running following github action (on `master` branch) - `Release : Draft Notes`. While running the action you have to provide 2 inputs:
- **Tag** : Provide current package version
- **Previous Tag** : Provide previously released tag version
7. Publish docker image by running `Release : Docker` action in github (on `master` branch), where you have to provide the package version/tag.
8. Finally update the populated release (remove issues which is not related to release) draft not and publish. In release note you can use `Auto-generate release notes` button to populate release content from commits & PR.

16844
packages/noco-docs/package-lock.json generated

File diff suppressed because it is too large Load Diff

2
packages/noco-docs/package.json

@ -3,7 +3,7 @@
"version": "1.0.0", "version": "1.0.0",
"license": "MIT", "license": "MIT",
"scripts": { "scripts": {
"dev": "nuxt", "dev": "NODE_OPTIONS=--openssl-legacy-provider nuxt",
"build": "nuxt build", "build": "nuxt build",
"start": "nuxt start", "start": "nuxt start",
"generate": "nuxt generate" "generate": "nuxt generate"

Loading…
Cancel
Save