Skip to main content

This project uses conventional commits loosely as the specification for our commits.

Commit message will be in the format:

type(scope): title

body

This page will document the types and scopes used.

Types

TypeDescription
buildChanges that affect the build system or external dependencies (example scopes: nix)
configChanges to the configuration files (example scopes: nix, ci)
ciChanges to our CI configuration files and scripts (example scopes: github_workflow, github_action)
docsDocumentation only changes
featA new feature
fixA bug fix
perfA code change that improves performance
refactorA code change that neither fixes a bug nor adds a feature
styleChanges that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)
testAdding missing tests or correcting existing tests
amendAny amendment, uncategorized, or small mistakes (like typos)

build

Changes that affect the build system or external dependencies (example scopes: nix)

ScopeDescriptionBump
defaultFixes in nixnil

config

Changes to the configuration files (example scopes: nix, ci)

ScopeDescriptionBump
defaultUpdate configuration filesnil

ci

Changes to our CI configuration files and scripts (example scopes: github_workflow, github_action)

ScopeDescriptionBump
defaultUpdate CI configurationnil

docs

Documentation only changes

ScopeDescriptionBump
defaultUpdate documentation such as README filenil

feat

A new feature

V.A.EV.A.E values
verbadd
applicationwhen this commit is applied, it will add <scope>, <title>
examplefeat: new withdraw api for rapid
example appliedwhen this commit is applied, it will add null, new withdraw api for rapid
ScopeDescriptionBump
defaultRelease a new featuresminor

fix

A bug fix

V.A.EV.A.E values
verbfix
applicationwhen this commit is applied, it will fix <title>
examplefix: deposit api for rapid
example appliedwhen this commit is applied, it will fix deposit api for rapid
ScopeDescriptionBump
defaultGeneric fixespatch

perf

A code change that improves performance

V.A.EV.A.E values
verbimprove
applicationwhen this commit is applied, it will improve <title>
exampleperf: alpaca api callback speed increase
example appliedwhen this commit is applied, it will improve alpaca api callback speed increase
ScopeDescriptionBump
defaultGeneric improvement statementpatch

refactor

A code change that neither fixes a bug nor adds a feature

V.A.EV.A.E values
verbrefactor
applicationwhen this commit is applied, it will refactor <scope>, <title>
examplerefactor: make withdrawal code more reusable
example appliedwhen this commit is applied, it will refactor null, make withdrawal code more reusable
ScopeDescriptionBump
defaultRefactor existing featureminor

style

Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)

V.A.EV.A.E values
verbstyle
applicationwhen this commit is applied, it will style <title>
examplestyle: add missing semi colon
example appliedwhen this commit is applied, it will style add missing semi colon
ScopeDescriptionBump
defaultGeneric improvement statementpatch

test

Adding missing tests or correcting existing tests

V.A.EV.A.E values
verbtest
applicationwhen this commit is applied, it will test <scope>, <title>
exampletest: update test for deposit api
example appliedwhen this commit is applied, it will test null, update test for deposit api
ScopeDescriptionBump
defaultMade changes to testminor

amend

Any amendment, uncategorized, or small mistakes (like typos)

ScopeDescriptionBump
defaultamendmentsnil

Special Scopes

ScopeDescriptionBump
no-releasePrevent release from happeningnil