From 1f5e69da9a4321b17bd62ab2bc9260cd78c0b154 Mon Sep 17 00:00:00 2001 From: Victor Reijgwart Date: Fri, 8 Sep 2023 14:19:36 +0200 Subject: [PATCH 1/6] Create SECURITY.md --- SECURITY.md | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 SECURITY.md diff --git a/SECURITY.md b/SECURITY.md new file mode 100644 index 000000000..4f11f2fd2 --- /dev/null +++ b/SECURITY.md @@ -0,0 +1,5 @@ +# Security Policy + +We currently do not expect wavemap to be exposed in security-sensitive contexts. If you intend to use wavemap in such a scenario, please contact victor.reijgwart@ethz-asl.ch so that we are aware and can discuss it. + +We would be happy to merge security-related patches and assist with security-related improvements. From 0d4fe93e1bf6d08d101e9041c49b7449a4b6ae82 Mon Sep 17 00:00:00 2001 From: Victor Reijgwart Date: Fri, 8 Sep 2023 17:34:56 +0200 Subject: [PATCH 2/6] Update the documentation on how to contribute --- .github/CONTRIBUTING.md | 5 ++ .github/ISSUE_TEMPLATE/question.md | 44 ++++++++++++++ SECURITY.md => .github/SECURITY.md | 0 docs/pages/contributing.rst | 58 ++++++++++++++++++- .../wavemap_utils/scripts/preview_docs.sh | 5 +- 5 files changed, 107 insertions(+), 5 deletions(-) create mode 100644 .github/CONTRIBUTING.md create mode 100644 .github/ISSUE_TEMPLATE/question.md rename SECURITY.md => .github/SECURITY.md (100%) diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md new file mode 100644 index 000000000..532554d1c --- /dev/null +++ b/.github/CONTRIBUTING.md @@ -0,0 +1,5 @@ +# Contributing + +Thank you for investing time in contributing to wavemap! + +Please see the documentation page on [contributing](https://ethz-asl.github.io/wavemap/pages/contributing.html) to get started. diff --git a/.github/ISSUE_TEMPLATE/question.md b/.github/ISSUE_TEMPLATE/question.md new file mode 100644 index 000000000..d8c8714e0 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/question.md @@ -0,0 +1,44 @@ +--- +name: Question +about: Ask a general question +title: '' +labels: +assignees: victorreijgwart + +--- + +**Question** +A clear and concise description of your question. + +**Existing resources** +Before submitting this question, please check if it has not already been answered in a previous [GitHub Issue](https://github.com/ethz-asl/wavemap/issues?q=is%3Aissue). + +If the question is about the theory behind wavemap, it might already be addressed in our [RSS paper](https://www.roboticsproceedings.org/rss19/p065.pdf). + +If you would like to reproduce the results from our [RSS paper](https://www.roboticsproceedings.org/rss19/p065.pdf), please refer to the [Demo](https://ethz-asl.github.io/wavemap/pages/demos.html) documentation page. + +If you need help to configure wavemap on a custom dataset, the [Configuration](https://ethz-asl.github.io/wavemap/pages/configuration.html) documentation page might be helpful. + +**Images** +In case it helps to explain your question, please include screenshots, plots or sketches. + +**Runtime information:** +Please fill out these questions in case a specific dataset or sensor setup is relevant to your question. + +- Launch file: [e.g. Link to the launch file you used] +- Config file: [e.g. Link to the config file you used] +- Dataset name [e.g. Newer College Cloister sequence] # For public datasets +- Custom setup: # For online use or personal datasets + - depth sensor: [e.g. Livox MID360 LiDAR] + - pose source: [e.g. Odometry from FastLIO2] + +**System information:** +Please fill out these questions in case your hardware is relevant to your question. For example, if you would like help to tune wavemap's performance on your robot. + +- CPU: [e.g. Intel i9-9900K] +- GPU: [e.g. Nvidia RTX 2080Ti] # Only for visualization-related issues +- RAM: [e.g. 32GB] +- OS: [e.g. Ubuntu 20.04] +- Wavemap + - install: [e.g., Native (ROS with catkin); or Docker] + - version: [e.g., v1.4.0] diff --git a/SECURITY.md b/.github/SECURITY.md similarity index 100% rename from SECURITY.md rename to .github/SECURITY.md diff --git a/docs/pages/contributing.rst b/docs/pages/contributing.rst index 219b19016..b9a323462 100644 --- a/docs/pages/contributing.rst +++ b/docs/pages/contributing.rst @@ -1,17 +1,71 @@ Contributing ############ .. highlight:: bash +.. rstcheck: ignore-roles=repo_file -We are extending wavemap's API and invite you to share requests for specific interfaces by opening a `GitHub issue `_. Additionally, we encourage code merge requests and would be happy to review and help you optimize contributed code. +Thank you for investing time in contributing to wavemap! -To maintain code quality, we use the pre-commit framework to automatically format, lint and perform basic code checks. You can install pre-commit together with the dependencies required to run all of wavemap's checks with:: +Bug reports & Feature requests +****************************** +We welcome bug reports, feature requests and general questions. Please submit them through `GitHub Issues `_ and use the corresponding `bug report `_, `feature request `_ and `question `_ templates. + +In addition to requests for new functionality, do not hesitate to open feature requests for: + +* API methods and interfaces +* Extensions to the documentation and examples + +Pull requests +************* +We encourage `pull requests `_, especially for fixes and improvements to the documentation, code and ROS launch and config files. Also feel free to share launch and config files for new sensor setups and applications. + +In case you would like to contribute a new feature, please open a corresponding `feature request `_ before you get started and mention that you are willing to help with its development. This way we can synchronize and avoid duplicated efforts. + +Development +*********** + +Coding standards +================ +This project follows the `Google Style Guide `_ for C++. + +To maintain code quality, we use the `pre-commit `_ framework to automatically format, lint and perform basic code checks. You can install pre-commit together with the dependencies required to run all of wavemap's checks with:: rosrun wavemap_utils install_pre_commit.sh After running the above script, pre-commit will automatically check changed code when it is committed to git. All the checks can also be run manually at any time by calling:: + # cd ~/catkin_ws/src/wavemap pre-commit run --all +In case you really need to commit some changes that are not accepted by pre-commit, you can use git's ``--no-verify`` flag as:: + + git commit --no-verify -m "Your commit message" + +Testing +======= Wavemap's codebase includes a broad suite of tests. These are run in our Continuous Integration pipeline for active merge requests, `see here `_. You can also run the tests locally with:: rosrun wavemap_utils build_and_test_all.sh + +The tests are located in the `test` subfolders of each package and implemented using the `GoogleTest `_ framework. + +Documentation +============= +The documentation consists of pages for specific topics, located in the :repo_file:`docs/pages ` directory, and inline Doxygen annotations for the C++ source code. + +To read the documentation for a specific wavemap version: + +Latest release +-------------- +Browse to https://ethz-asl.github.io/wavemap. + +Specific release +---------------- +Find the release in question under `GitHub Releases `_. Under `Assets`, at the bottom of the release's description, click and download `docs.tar`. Then unpack the archive into an empty folder and double click index.html to open it in a browser. + +Locally +------- +In a terminal, run:: + + rosrun wavemap_utils preview_docs.sh + +This will build a preview of the documentation based on your local wavemap version and changes, and open the result in a web browser. diff --git a/tooling/packages/wavemap_utils/scripts/preview_docs.sh b/tooling/packages/wavemap_utils/scripts/preview_docs.sh index ace54bd45..a80fb72c9 100755 --- a/tooling/packages/wavemap_utils/scripts/preview_docs.sh +++ b/tooling/packages/wavemap_utils/scripts/preview_docs.sh @@ -8,6 +8,5 @@ cd "$(rospack find wavemap)"/../.. || exit 1 # Build the docs sphinx-build -b html docs docs/_build/html -# Start a small server and open in browser -xdg-open http://0.0.0.0:8000/ -python3 -m http.server --directory docs/_build/html/ +# Open in browser +xdg-open docs/_build/html/index.html From cb2192446d220cd41bfb8eacf6bee233da339e63 Mon Sep 17 00:00:00 2001 From: Victor Reijgwart Date: Fri, 8 Sep 2023 17:45:00 +0200 Subject: [PATCH 3/6] Add code of conduct --- .github/CODE_OF_CONDUCT.md | 128 +++++++++++++++++++++++++++++ .github/ISSUE_TEMPLATE/question.md | 6 +- docs/pages/contributing.rst | 12 +-- 3 files changed, 137 insertions(+), 9 deletions(-) create mode 100644 .github/CODE_OF_CONDUCT.md diff --git a/.github/CODE_OF_CONDUCT.md b/.github/CODE_OF_CONDUCT.md new file mode 100644 index 000000000..419553960 --- /dev/null +++ b/.github/CODE_OF_CONDUCT.md @@ -0,0 +1,128 @@ +# Contributor Covenant Code of Conduct + +## Our Pledge + +We as members, contributors, and leaders pledge to make participation in our +community a harassment-free experience for everyone, regardless of age, body +size, visible or invisible disability, ethnicity, sex characteristics, gender +identity and expression, level of experience, education, socio-economic status, +nationality, personal appearance, race, religion, or sexual identity +and orientation. + +We pledge to act and interact in ways that contribute to an open, welcoming, +diverse, inclusive, and healthy community. + +## Our Standards + +Examples of behavior that contributes to a positive environment for our +community include: + +* Demonstrating empathy and kindness toward other people +* Being respectful of differing opinions, viewpoints, and experiences +* Giving and gracefully accepting constructive feedback +* Accepting responsibility and apologizing to those affected by our mistakes, + and learning from the experience +* Focusing on what is best not just for us as individuals, but for the + overall community + +Examples of unacceptable behavior include: + +* The use of sexualized language or imagery, and sexual attention or + advances of any kind +* Trolling, insulting or derogatory comments, and personal or political attacks +* Public or private harassment +* Publishing others' private information, such as a physical or email + address, without their explicit permission +* Other conduct which could reasonably be considered inappropriate in a + professional setting + +## Enforcement Responsibilities + +Community leaders are responsible for clarifying and enforcing our standards of +acceptable behavior and will take appropriate and fair corrective action in +response to any behavior that they deem inappropriate, threatening, offensive, +or harmful. + +Community leaders have the right and responsibility to remove, edit, or reject +comments, commits, code, wiki edits, issues, and other contributions that are +not aligned to this Code of Conduct, and will communicate reasons for moderation +decisions when appropriate. + +## Scope + +This Code of Conduct applies within all community spaces, and also applies when +an individual is officially representing the community in public spaces. +Examples of representing our community include using an official e-mail address, +posting via an official social media account, or acting as an appointed +representative at an online or offline event. + +## Enforcement + +Instances of abusive, harassing, or otherwise unacceptable behavior may be +reported to the community leaders responsible for enforcement at +victor.reijgwart@ethz-asl.ch. +All complaints will be reviewed and investigated promptly and fairly. + +All community leaders are obligated to respect the privacy and security of the +reporter of any incident. + +## Enforcement Guidelines + +Community leaders will follow these Community Impact Guidelines in determining +the consequences for any action they deem in violation of this Code of Conduct: + +### 1. Correction + +**Community Impact**: Use of inappropriate language or other behavior deemed +unprofessional or unwelcome in the community. + +**Consequence**: A private, written warning from community leaders, providing +clarity around the nature of the violation and an explanation of why the +behavior was inappropriate. A public apology may be requested. + +### 2. Warning + +**Community Impact**: A violation through a single incident or series +of actions. + +**Consequence**: A warning with consequences for continued behavior. No +interaction with the people involved, including unsolicited interaction with +those enforcing the Code of Conduct, for a specified period of time. This +includes avoiding interactions in community spaces as well as external channels +like social media. Violating these terms may lead to a temporary or +permanent ban. + +### 3. Temporary Ban + +**Community Impact**: A serious violation of community standards, including +sustained inappropriate behavior. + +**Consequence**: A temporary ban from any sort of interaction or public +communication with the community for a specified period of time. No public or +private interaction with the people involved, including unsolicited interaction +with those enforcing the Code of Conduct, is allowed during this period. +Violating these terms may lead to a permanent ban. + +### 4. Permanent Ban + +**Community Impact**: Demonstrating a pattern of violation of community +standards, including sustained inappropriate behavior, harassment of an +individual, or aggression toward or disparagement of classes of individuals. + +**Consequence**: A permanent ban from any sort of public interaction within +the community. + +## Attribution + +This Code of Conduct is adapted from the [Contributor Covenant][homepage], +version 2.0, available at +https://www.contributor-covenant.org/version/2/0/code_of_conduct.html. + +Community Impact Guidelines were inspired by [Mozilla's code of conduct +enforcement ladder](https://github.com/mozilla/diversity). + +[homepage]: https://www.contributor-covenant.org + +For answers to common questions about this code of conduct, see the FAQ at +https://www.contributor-covenant.org/faq. Translations are available at +https://www.contributor-covenant.org/translations. diff --git a/.github/ISSUE_TEMPLATE/question.md b/.github/ISSUE_TEMPLATE/question.md index d8c8714e0..bb507ee59 100644 --- a/.github/ISSUE_TEMPLATE/question.md +++ b/.github/ISSUE_TEMPLATE/question.md @@ -11,16 +11,16 @@ assignees: victorreijgwart A clear and concise description of your question. **Existing resources** -Before submitting this question, please check if it has not already been answered in a previous [GitHub Issue](https://github.com/ethz-asl/wavemap/issues?q=is%3Aissue). +Before submitting this question, please check if it has been answered in a previous [GitHub Issue](https://github.com/ethz-asl/wavemap/issues?q=is%3Aissue). If the question is about the theory behind wavemap, it might already be addressed in our [RSS paper](https://www.roboticsproceedings.org/rss19/p065.pdf). If you would like to reproduce the results from our [RSS paper](https://www.roboticsproceedings.org/rss19/p065.pdf), please refer to the [Demo](https://ethz-asl.github.io/wavemap/pages/demos.html) documentation page. -If you need help to configure wavemap on a custom dataset, the [Configuration](https://ethz-asl.github.io/wavemap/pages/configuration.html) documentation page might be helpful. +If you need help configuring wavemap on a custom dataset, the [Configuration](https://ethz-asl.github.io/wavemap/pages/configuration.html) documentation page might be helpful. **Images** -In case it helps to explain your question, please include screenshots, plots or sketches. +If it helps to explain your question, please include screenshots, plots or sketches. **Runtime information:** Please fill out these questions in case a specific dataset or sensor setup is relevant to your question. diff --git a/docs/pages/contributing.rst b/docs/pages/contributing.rst index b9a323462..9c487376a 100644 --- a/docs/pages/contributing.rst +++ b/docs/pages/contributing.rst @@ -7,7 +7,7 @@ Thank you for investing time in contributing to wavemap! Bug reports & Feature requests ****************************** -We welcome bug reports, feature requests and general questions. Please submit them through `GitHub Issues `_ and use the corresponding `bug report `_, `feature request `_ and `question `_ templates. +We welcome bug reports, feature requests, and general questions. Please submit them through `GitHub Issues `_ and use the corresponding `bug report `_, `feature request `_, and `question `_ templates. In addition to requests for new functionality, do not hesitate to open feature requests for: @@ -16,9 +16,9 @@ In addition to requests for new functionality, do not hesitate to open feature r Pull requests ************* -We encourage `pull requests `_, especially for fixes and improvements to the documentation, code and ROS launch and config files. Also feel free to share launch and config files for new sensor setups and applications. +We encourage `pull requests `_, especially for fixes and improvements to the documentation, code, and ROS launch and config files. Also feel free to share launch and config files for new sensor setups and applications. -In case you would like to contribute a new feature, please open a corresponding `feature request `_ before you get started and mention that you are willing to help with its development. This way we can synchronize and avoid duplicated efforts. +If you would like to contribute a new feature, please open a corresponding `feature request `_ before you start and mention that you are willing to help with its development. This way, we can synchronize and avoid duplicated efforts. Development *********** @@ -27,7 +27,7 @@ Coding standards ================ This project follows the `Google Style Guide `_ for C++. -To maintain code quality, we use the `pre-commit `_ framework to automatically format, lint and perform basic code checks. You can install pre-commit together with the dependencies required to run all of wavemap's checks with:: +To maintain code quality, we use the `pre-commit `_ framework to automatically format, lint, and perform basic code checks. You can install pre-commit together with the dependencies required to run all of wavemap's checks with:: rosrun wavemap_utils install_pre_commit.sh @@ -60,7 +60,7 @@ Browse to https://ethz-asl.github.io/wavemap. Specific release ---------------- -Find the release in question under `GitHub Releases `_. Under `Assets`, at the bottom of the release's description, click and download `docs.tar`. Then unpack the archive into an empty folder and double click index.html to open it in a browser. +Find the release in question under `GitHub Releases `_. Under `Assets`, at the bottom of the release's description, click and download `docs.tar`. Then unpack the archive into an empty folder and double-click index.html to open it in a browser. Locally ------- @@ -68,4 +68,4 @@ In a terminal, run:: rosrun wavemap_utils preview_docs.sh -This will build a preview of the documentation based on your local wavemap version and changes, and open the result in a web browser. +This will build a preview of the documentation based on your local wavemap version and changes and open the result in a web browser. From 9c0f74c69f85c621ea1841be2504ac2192007c33 Mon Sep 17 00:00:00 2001 From: Victor Reijgwart Date: Fri, 8 Sep 2023 18:18:27 +0200 Subject: [PATCH 4/6] Update changelogs --- libraries/wavemap/CHANGELOG.rst | 3 +++ libraries/wavemap_io/CHANGELOG.rst | 3 +++ ros/wavemap_msgs/CHANGELOG.rst | 3 +++ ros/wavemap_ros/CHANGELOG.rst | 3 +++ ros/wavemap_ros_conversions/CHANGELOG.rst | 3 +++ ros/wavemap_rviz_plugin/CHANGELOG.rst | 3 +++ tooling/packages/catkin_setup/CHANGELOG.rst | 3 +++ tooling/packages/wavemap_all/CHANGELOG.rst | 3 +++ tooling/packages/wavemap_utils/CHANGELOG.rst | 5 +++++ 9 files changed, 29 insertions(+) diff --git a/libraries/wavemap/CHANGELOG.rst b/libraries/wavemap/CHANGELOG.rst index bd01777be..d1a2587ed 100644 --- a/libraries/wavemap/CHANGELOG.rst +++ b/libraries/wavemap/CHANGELOG.rst @@ -2,6 +2,9 @@ Changelog for package wavemap ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Forthcoming +----------- + 1.5.0 (2023-09-05) ------------------ * Annotate code for profiling with Tracy Profiler diff --git a/libraries/wavemap_io/CHANGELOG.rst b/libraries/wavemap_io/CHANGELOG.rst index 3f0aff3b9..f6b46001c 100644 --- a/libraries/wavemap_io/CHANGELOG.rst +++ b/libraries/wavemap_io/CHANGELOG.rst @@ -2,6 +2,9 @@ Changelog for package wavemap_io ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Forthcoming +----------- + 1.5.0 (2023-09-05) ------------------ * Improve error messages when reading/writing a file fails diff --git a/ros/wavemap_msgs/CHANGELOG.rst b/ros/wavemap_msgs/CHANGELOG.rst index 7f465e134..c5d60e687 100644 --- a/ros/wavemap_msgs/CHANGELOG.rst +++ b/ros/wavemap_msgs/CHANGELOG.rst @@ -2,6 +2,9 @@ Changelog for package wavemap_msgs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Forthcoming +----------- + 1.5.0 (2023-09-05) ------------------ diff --git a/ros/wavemap_ros/CHANGELOG.rst b/ros/wavemap_ros/CHANGELOG.rst index bd0b3dee3..57db14153 100644 --- a/ros/wavemap_ros/CHANGELOG.rst +++ b/ros/wavemap_ros/CHANGELOG.rst @@ -2,6 +2,9 @@ Changelog for package wavemap_ros ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Forthcoming +----------- + 1.5.0 (2023-09-05) ------------------ * Annotate code for profiling with Tracy Profiler diff --git a/ros/wavemap_ros_conversions/CHANGELOG.rst b/ros/wavemap_ros_conversions/CHANGELOG.rst index 74d2ba37c..b594da817 100644 --- a/ros/wavemap_ros_conversions/CHANGELOG.rst +++ b/ros/wavemap_ros_conversions/CHANGELOG.rst @@ -2,6 +2,9 @@ Changelog for package wavemap_ros_conversions ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Forthcoming +----------- + 1.5.0 (2023-09-05) ------------------ * Annotate code for profiling with Tracy Profiler diff --git a/ros/wavemap_rviz_plugin/CHANGELOG.rst b/ros/wavemap_rviz_plugin/CHANGELOG.rst index 1ed4b582c..3585528af 100644 --- a/ros/wavemap_rviz_plugin/CHANGELOG.rst +++ b/ros/wavemap_rviz_plugin/CHANGELOG.rst @@ -2,6 +2,9 @@ Changelog for package wavemap_rviz_plugin ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Forthcoming +----------- + 1.5.0 (2023-09-05) ------------------ diff --git a/tooling/packages/catkin_setup/CHANGELOG.rst b/tooling/packages/catkin_setup/CHANGELOG.rst index 580f061a1..b03177e8d 100644 --- a/tooling/packages/catkin_setup/CHANGELOG.rst +++ b/tooling/packages/catkin_setup/CHANGELOG.rst @@ -2,6 +2,9 @@ Changelog for package catkin_setup ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Forthcoming +----------- + 1.5.0 (2023-09-05) ------------------ diff --git a/tooling/packages/wavemap_all/CHANGELOG.rst b/tooling/packages/wavemap_all/CHANGELOG.rst index 23f8e69dd..9c7597fcb 100644 --- a/tooling/packages/wavemap_all/CHANGELOG.rst +++ b/tooling/packages/wavemap_all/CHANGELOG.rst @@ -2,6 +2,9 @@ Changelog for package wavemap_all ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Forthcoming +----------- + 1.5.0 (2023-09-05) ------------------ diff --git a/tooling/packages/wavemap_utils/CHANGELOG.rst b/tooling/packages/wavemap_utils/CHANGELOG.rst index 7e8a6da54..3abaaccb5 100644 --- a/tooling/packages/wavemap_utils/CHANGELOG.rst +++ b/tooling/packages/wavemap_utils/CHANGELOG.rst @@ -2,6 +2,11 @@ Changelog for package wavemap_utils ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Forthcoming +----------- +* Show documentation preview without using Python HTTP server +* Contributors: Victor Reijgwart + 1.5.0 (2023-09-05) ------------------ From 7f293b96b3b25667a6acf8b03112186cece3e55a Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Fri, 8 Sep 2023 16:19:40 +0000 Subject: [PATCH 5/6] Prepare release 1.5.1 --- libraries/wavemap/CHANGELOG.rst | 4 ++-- libraries/wavemap/package.xml | 2 +- libraries/wavemap_io/CHANGELOG.rst | 4 ++-- libraries/wavemap_io/package.xml | 2 +- ros/wavemap_msgs/CHANGELOG.rst | 4 ++-- ros/wavemap_msgs/package.xml | 2 +- ros/wavemap_ros/CHANGELOG.rst | 4 ++-- ros/wavemap_ros/package.xml | 2 +- ros/wavemap_ros_conversions/CHANGELOG.rst | 4 ++-- ros/wavemap_ros_conversions/package.xml | 2 +- ros/wavemap_rviz_plugin/CHANGELOG.rst | 4 ++-- ros/wavemap_rviz_plugin/package.xml | 2 +- tooling/packages/catkin_setup/CHANGELOG.rst | 4 ++-- tooling/packages/catkin_setup/package.xml | 2 +- tooling/packages/wavemap_all/CHANGELOG.rst | 4 ++-- tooling/packages/wavemap_all/package.xml | 2 +- tooling/packages/wavemap_utils/CHANGELOG.rst | 4 ++-- tooling/packages/wavemap_utils/package.xml | 2 +- 18 files changed, 27 insertions(+), 27 deletions(-) diff --git a/libraries/wavemap/CHANGELOG.rst b/libraries/wavemap/CHANGELOG.rst index d1a2587ed..b897b7c98 100644 --- a/libraries/wavemap/CHANGELOG.rst +++ b/libraries/wavemap/CHANGELOG.rst @@ -2,8 +2,8 @@ Changelog for package wavemap ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -Forthcoming ------------ +1.5.1 (2023-09-08) +------------------ 1.5.0 (2023-09-05) ------------------ diff --git a/libraries/wavemap/package.xml b/libraries/wavemap/package.xml index 423e4c3a3..0ee8f2a56 100644 --- a/libraries/wavemap/package.xml +++ b/libraries/wavemap/package.xml @@ -1,7 +1,7 @@ wavemap - 1.5.0 + 1.5.1 Base library for wavemap. Victor Reijgwart diff --git a/libraries/wavemap_io/CHANGELOG.rst b/libraries/wavemap_io/CHANGELOG.rst index f6b46001c..33679501a 100644 --- a/libraries/wavemap_io/CHANGELOG.rst +++ b/libraries/wavemap_io/CHANGELOG.rst @@ -2,8 +2,8 @@ Changelog for package wavemap_io ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -Forthcoming ------------ +1.5.1 (2023-09-08) +------------------ 1.5.0 (2023-09-05) ------------------ diff --git a/libraries/wavemap_io/package.xml b/libraries/wavemap_io/package.xml index 39bf62f16..c7b00326f 100644 --- a/libraries/wavemap_io/package.xml +++ b/libraries/wavemap_io/package.xml @@ -1,7 +1,7 @@ wavemap_io - 1.5.0 + 1.5.1 (De)serialization of wavemap types to files. Victor Reijgwart diff --git a/ros/wavemap_msgs/CHANGELOG.rst b/ros/wavemap_msgs/CHANGELOG.rst index c5d60e687..b4eb18a18 100644 --- a/ros/wavemap_msgs/CHANGELOG.rst +++ b/ros/wavemap_msgs/CHANGELOG.rst @@ -2,8 +2,8 @@ Changelog for package wavemap_msgs ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -Forthcoming ------------ +1.5.1 (2023-09-08) +------------------ 1.5.0 (2023-09-05) ------------------ diff --git a/ros/wavemap_msgs/package.xml b/ros/wavemap_msgs/package.xml index 359191447..430da0cd4 100644 --- a/ros/wavemap_msgs/package.xml +++ b/ros/wavemap_msgs/package.xml @@ -1,7 +1,7 @@ wavemap_msgs - 1.5.0 + 1.5.1 Message definitions for wavemap's ROS interfaces. Victor Reijgwart diff --git a/ros/wavemap_ros/CHANGELOG.rst b/ros/wavemap_ros/CHANGELOG.rst index 57db14153..12c0c5b3c 100644 --- a/ros/wavemap_ros/CHANGELOG.rst +++ b/ros/wavemap_ros/CHANGELOG.rst @@ -2,8 +2,8 @@ Changelog for package wavemap_ros ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -Forthcoming ------------ +1.5.1 (2023-09-08) +------------------ 1.5.0 (2023-09-05) ------------------ diff --git a/ros/wavemap_ros/package.xml b/ros/wavemap_ros/package.xml index 1f5b7820d..33761425b 100644 --- a/ros/wavemap_ros/package.xml +++ b/ros/wavemap_ros/package.xml @@ -1,7 +1,7 @@ wavemap_ros - 1.5.0 + 1.5.1 ROS interface for wavemap. Victor Reijgwart diff --git a/ros/wavemap_ros_conversions/CHANGELOG.rst b/ros/wavemap_ros_conversions/CHANGELOG.rst index b594da817..25da153de 100644 --- a/ros/wavemap_ros_conversions/CHANGELOG.rst +++ b/ros/wavemap_ros_conversions/CHANGELOG.rst @@ -2,8 +2,8 @@ Changelog for package wavemap_ros_conversions ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -Forthcoming ------------ +1.5.1 (2023-09-08) +------------------ 1.5.0 (2023-09-05) ------------------ diff --git a/ros/wavemap_ros_conversions/package.xml b/ros/wavemap_ros_conversions/package.xml index 3a7b8c9f9..317e767a7 100644 --- a/ros/wavemap_ros_conversions/package.xml +++ b/ros/wavemap_ros_conversions/package.xml @@ -1,7 +1,7 @@ wavemap_ros_conversions - 1.5.0 + 1.5.1 Conversions between wavemap and ROS types. Victor Reijgwart diff --git a/ros/wavemap_rviz_plugin/CHANGELOG.rst b/ros/wavemap_rviz_plugin/CHANGELOG.rst index 3585528af..173790376 100644 --- a/ros/wavemap_rviz_plugin/CHANGELOG.rst +++ b/ros/wavemap_rviz_plugin/CHANGELOG.rst @@ -2,8 +2,8 @@ Changelog for package wavemap_rviz_plugin ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -Forthcoming ------------ +1.5.1 (2023-09-08) +------------------ 1.5.0 (2023-09-05) ------------------ diff --git a/ros/wavemap_rviz_plugin/package.xml b/ros/wavemap_rviz_plugin/package.xml index 1dbc22161..8a7bdf2ac 100644 --- a/ros/wavemap_rviz_plugin/package.xml +++ b/ros/wavemap_rviz_plugin/package.xml @@ -1,7 +1,7 @@ wavemap_rviz_plugin - 1.5.0 + 1.5.1 Plugin to interactively visualize maps published in wavemap's native format. diff --git a/tooling/packages/catkin_setup/CHANGELOG.rst b/tooling/packages/catkin_setup/CHANGELOG.rst index b03177e8d..43e8cc8cd 100644 --- a/tooling/packages/catkin_setup/CHANGELOG.rst +++ b/tooling/packages/catkin_setup/CHANGELOG.rst @@ -2,8 +2,8 @@ Changelog for package catkin_setup ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -Forthcoming ------------ +1.5.1 (2023-09-08) +------------------ 1.5.0 (2023-09-05) ------------------ diff --git a/tooling/packages/catkin_setup/package.xml b/tooling/packages/catkin_setup/package.xml index 5e3f55fb7..1d1fb18a3 100644 --- a/tooling/packages/catkin_setup/package.xml +++ b/tooling/packages/catkin_setup/package.xml @@ -1,7 +1,7 @@ catkin_setup - 1.5.0 + 1.5.1 Dummy package to make it easy to setup the workspace and generate the setup.[sh|bash|zsh] scripts in CI. Victor Reijgwart diff --git a/tooling/packages/wavemap_all/CHANGELOG.rst b/tooling/packages/wavemap_all/CHANGELOG.rst index 9c7597fcb..3806b2446 100644 --- a/tooling/packages/wavemap_all/CHANGELOG.rst +++ b/tooling/packages/wavemap_all/CHANGELOG.rst @@ -2,8 +2,8 @@ Changelog for package wavemap_all ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -Forthcoming ------------ +1.5.1 (2023-09-08) +------------------ 1.5.0 (2023-09-05) ------------------ diff --git a/tooling/packages/wavemap_all/package.xml b/tooling/packages/wavemap_all/package.xml index c0092ea2e..64b750fa1 100644 --- a/tooling/packages/wavemap_all/package.xml +++ b/tooling/packages/wavemap_all/package.xml @@ -1,7 +1,7 @@ wavemap_all - 1.5.0 + 1.5.1 Metapackage that builds all wavemap packages. Victor Reijgwart diff --git a/tooling/packages/wavemap_utils/CHANGELOG.rst b/tooling/packages/wavemap_utils/CHANGELOG.rst index 3abaaccb5..ed657a39b 100644 --- a/tooling/packages/wavemap_utils/CHANGELOG.rst +++ b/tooling/packages/wavemap_utils/CHANGELOG.rst @@ -2,8 +2,8 @@ Changelog for package wavemap_utils ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -Forthcoming ------------ +1.5.1 (2023-09-08) +------------------ * Show documentation preview without using Python HTTP server * Contributors: Victor Reijgwart diff --git a/tooling/packages/wavemap_utils/package.xml b/tooling/packages/wavemap_utils/package.xml index 63fef660a..218d0524d 100644 --- a/tooling/packages/wavemap_utils/package.xml +++ b/tooling/packages/wavemap_utils/package.xml @@ -1,7 +1,7 @@ wavemap_utils - 1.5.0 + 1.5.1 Small package containing scripts to simplify common wavemap development tasks. Victor Reijgwart From 04e3927399a0971b439f755225b8a078d38bb4c0 Mon Sep 17 00:00:00 2001 From: Victor Reijgwart Date: Fri, 8 Sep 2023 18:36:09 +0200 Subject: [PATCH 6/6] Restructure Contributing page outline --- docs/pages/contributing.rst | 17 +++++++---------- 1 file changed, 7 insertions(+), 10 deletions(-) diff --git a/docs/pages/contributing.rst b/docs/pages/contributing.rst index 9c487376a..ac13326ad 100644 --- a/docs/pages/contributing.rst +++ b/docs/pages/contributing.rst @@ -20,11 +20,8 @@ We encourage `pull requests `_, espec If you would like to contribute a new feature, please open a corresponding `feature request `_ before you start and mention that you are willing to help with its development. This way, we can synchronize and avoid duplicated efforts. -Development -*********** - Coding standards -================ +**************** This project follows the `Google Style Guide `_ for C++. To maintain code quality, we use the `pre-commit `_ framework to automatically format, lint, and perform basic code checks. You can install pre-commit together with the dependencies required to run all of wavemap's checks with:: @@ -41,7 +38,7 @@ In case you really need to commit some changes that are not accepted by pre-comm git commit --no-verify -m "Your commit message" Testing -======= +******* Wavemap's codebase includes a broad suite of tests. These are run in our Continuous Integration pipeline for active merge requests, `see here `_. You can also run the tests locally with:: rosrun wavemap_utils build_and_test_all.sh @@ -49,21 +46,21 @@ Wavemap's codebase includes a broad suite of tests. These are run in our Continu The tests are located in the `test` subfolders of each package and implemented using the `GoogleTest `_ framework. Documentation -============= +************* The documentation consists of pages for specific topics, located in the :repo_file:`docs/pages ` directory, and inline Doxygen annotations for the C++ source code. To read the documentation for a specific wavemap version: Latest release --------------- +============== Browse to https://ethz-asl.github.io/wavemap. Specific release ----------------- +================ Find the release in question under `GitHub Releases `_. Under `Assets`, at the bottom of the release's description, click and download `docs.tar`. Then unpack the archive into an empty folder and double-click index.html to open it in a browser. -Locally -------- +Local version +============= In a terminal, run:: rosrun wavemap_utils preview_docs.sh