reitit/doc/development.md
2021-04-23 17:53:53 +03:00

52 lines
1.1 KiB
Markdown

# Development Instructions
## Building
```bash
./scripts/lein-modules do clean, install
```
## Running tests
```bash
./scripts/test.sh clj
./scripts/test.sh cljs
```
## Documentation
The documentation lives under `doc` and it is hosted on [cljdoc](https://cljdoc.org). See their
documentation for [library authors](https://github.com/cljdoc/cljdoc/blob/master/doc/userguide/for-library-authors.adoc)
## Making a release
We use [Break Versioning][breakver]. Remember our promise: patch-level bumps never include breaking changes!
[breakver]: https://github.com/ptaoussanis/encore/blob/master/BREAK-VERSIONING.md
```bash
# Check that you're using Java 8! Making the release with a newer Java version
# means that it is broken when used with Java 8.
java -version
# new version
./scripts/set-version "1.0.0"
# create a release commit and a tag
git add -u
git commit -m "Release 1.0.0"
git tag 1.0.0
# works
./scripts/lein-modules install
lein test
# deploy to clojars
./scripts/lein-modules do clean, deploy clojars
# push the commit and the tag
git push
git push --tags
```
Remember to update the changelog as well!