From: Jiri Vlasak Date: Mon, 12 Jul 2021 18:34:46 +0000 (+0200) Subject: Update readme X-Git-Tag: v0.6.0~18^2~3 X-Git-Url: http://rtime.felk.cvut.cz/gitweb/hubacji1/bcar.git/commitdiff_plain/daae5d7836133b33ef97ed1b9c4b59e527cf946f Update readme --- diff --git a/README.md b/README.md index eb40efa..b6f0c83 100644 --- a/README.md +++ b/README.md @@ -1,32 +1,45 @@ -# BCar +BCar +==== + BCar is a C++ library with some geometric bicycle car computations. -# License +License +------- + The project is published under [MIT License][1]. [1]: ./LICENSE -# Build +Build +----- + To build the project run the following commands: -``` -mkdir build -cd build -cmake ../ -make -``` + + mkdir build + cd build + cmake ../ + make To build with ninja: -``` -mkdir build -cd build -cmake -DCMAKE_BUILD_TYPE=Release -G Ninja ../ -ninja -v -``` -# Contribute -Use [OneFlow][3] branching model and keep the [changelog][4]. + mkdir build + cd build + cmake -DCMAKE_BUILD_TYPE=Release -G Ninja ../ + ninja -v + +Contribute +---------- + +When adding feature or hotfix, use [Test-driven development][2]: + +1. Add tests to `ut` folder, add methods declaration, basic structure. +2. Run tests (just `make` in `build` folder), check that tests *fail*. +3. Implement functionality. +4. Run tests, check that tests *pass*. +5. Refactor. Write [great git commit messages][5]: + 1. Separate subject from body with a blank line. 2. Limit the subject line to 50 characters. 3. Capitalize the subject line. @@ -35,18 +48,11 @@ Write [great git commit messages][5]: 6. Wrap the body at 72 characters. 7. Use the body to explain what and why vs. how. -When adding feature or hotfix, use [Test-driven development (TDD)][2]: -1. Add tests to `ut` folder, add methods declaration, basic structure. -2. Run tests (just `make` in `build` folder), check that tests *fail*. -3. Implement functionality. -4. Run tests, check that tests *pass*. -5. Refactor. - [2]: https://en.wikipedia.org/wiki/Test-driven_development -[3]: https://www.endoflineblog.com/oneflow-a-git-branching-model-and-workflow -[4]: ./CHANGELOG.md [5]: https://chris.beams.io/posts/git-commit/ -# Documentation +Documentation +------------- + The documentation is generated by Doxygen, at least version `1.8.15` is needed. Just run `doxygen` in the project root directory.