-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* chore: add commitzen to repo * fix: fix panda paths and add commitzen * fix: fix formatting * docs: add contributing guide
- Loading branch information
1 parent
6bbe49f
commit 622f0a8
Showing
6 changed files
with
737 additions
and
2 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,3 @@ | ||
{ | ||
"path": "@commitlint/cz-commitlint" | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,53 @@ | ||
# Contributing to Treblle Documentation Platform | ||
|
||
## Preparing your enviroment | ||
|
||
### Node setup | ||
|
||
This repo has managed Node version via `.node-version` file so it's mandatory to have some node version management tool installed. | ||
We recommend either: | ||
|
||
- [fnm](https://github.com/Schniz/fnm) (built with Rust, much faster) | ||
- [nvm](https://github.com/nvm-sh/nvm) | ||
|
||
### Package manager setup | ||
|
||
The official package manager for monorepo is defined in root `package.json` file under `packageManager` field. | ||
Our current package manager is [pnpm](https://pnpm.io/). | ||
|
||
To install a package manager in currently used Node version run: | ||
|
||
```sh | ||
corepack enable | ||
``` | ||
|
||
## Installing | ||
|
||
After `pnpm` is installed run following command from monorepo root: | ||
|
||
```sh | ||
pnpm install | ||
``` | ||
|
||
## Updating dependencies | ||
|
||
To check for outdated dependencies, run: | ||
|
||
```sh | ||
pnpm outdated | ||
``` | ||
|
||
For more extensive information see [official docs](https://pnpm.io/cli/outdated) | ||
|
||
## Commits and release versioning | ||
|
||
Commit standards are based on [`@commitlint/config-conventional`](https://github.com/conventional-changelog/commitlint/blob/master/%40commitlint/config-conventional). | ||
|
||
For the sake of simplicity we are using [`commitizen`](https://commitizen.github.io/cz-cli/) | ||
|
||
### Creating a commit | ||
|
||
- stage changes you want to commit | ||
- run `pnpm commit` and follow the instructions | ||
- push your changes | ||
- profit 💰 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -14,6 +14,7 @@ | |
"author": "Treblle <[email protected]>", | ||
"scripts": { | ||
"build": "next build", | ||
"commit": "cz", | ||
"dev": "rm -rf .next && next dev", | ||
"format:check": "prettier . --check", | ||
"format:fix": "prettier . --write", | ||
|
@@ -32,13 +33,15 @@ | |
"devDependencies": { | ||
"@commitlint/cli": "^19.4.1", | ||
"@commitlint/config-conventional": "^19.4.1", | ||
"@commitlint/cz-commitlint": "^19.4.0", | ||
"@next/eslint-plugin-next": "14.2.7", | ||
"@pandacss/dev": "^0.45.2", | ||
"@types/node": "^20", | ||
"@types/react": "^18", | ||
"@types/react-dom": "^18", | ||
"@typescript-eslint/eslint-plugin": "^8.4.0", | ||
"@typescript-eslint/parser": "^8.4.0", | ||
"commitizen": "^4.3.0", | ||
"eslint": "^8", | ||
"eslint-config-prettier": "^9.1.0", | ||
"eslint-plugin-jsx-a11y": "^6.9.0", | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.