2018-05-20 16:49:41 +00:00
|
|
|
# Development Instructions
|
|
|
|
|
|
|
|
|
|
## Building
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
./scripts/lein-modules do clean, install
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Running tests
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
./scripts/test.sh clj
|
|
|
|
|
./scripts/test.sh cljs
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Documentation
|
|
|
|
|
|
2020-07-28 10:15:10 +00:00
|
|
|
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)
|
2018-05-20 16:49:41 +00:00
|
|
|
|
2021-03-05 18:45:28 +00:00
|
|
|
## Making a release
|
2018-05-20 16:49:41 +00:00
|
|
|
|
2019-03-14 07:50:21 +00:00
|
|
|
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
|
|
|
|
|
|
2018-05-20 16:49:41 +00:00
|
|
|
```bash
|
2021-03-05 18:45:28 +00:00
|
|
|
# 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
|
|
|
|
|
|
2018-05-20 16:49:41 +00:00
|
|
|
# new version
|
|
|
|
|
./scripts/set-version "1.0.0"
|
2021-04-23 14:53:53 +00:00
|
|
|
|
|
|
|
|
# create a release commit and a tag
|
|
|
|
|
git add -u
|
|
|
|
|
git commit -m "Release 1.0.0"
|
|
|
|
|
git tag 1.0.0
|
2018-05-20 16:49:41 +00:00
|
|
|
|
|
|
|
|
# works
|
2021-04-23 14:53:53 +00:00
|
|
|
./scripts/lein-modules install
|
2018-05-20 16:49:41 +00:00
|
|
|
lein test
|
|
|
|
|
|
|
|
|
|
# deploy to clojars
|
|
|
|
|
./scripts/lein-modules do clean, deploy clojars
|
2021-04-23 14:53:53 +00:00
|
|
|
|
|
|
|
|
# push the commit and the tag
|
|
|
|
|
git push
|
|
|
|
|
git push --tags
|
2018-05-20 16:49:41 +00:00
|
|
|
```
|
2021-04-23 14:53:53 +00:00
|
|
|
|
|
|
|
|
Remember to update the changelog as well!
|