Skip to content

Commit e759b4d

Browse files
Merge pull request #1254 from ApexAI/iox-#743-set-links-to-v2-0-0
iox-#743 Set all documentation links to `v2.0.0`
2 parents f030ed9 + 91dd909 commit e759b4d

File tree

37 files changed

+126
-124
lines changed

37 files changed

+126
-124
lines changed

CONTRIBUTING.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ Please make sure you have:
5858
7. You open your pull request towards the base branch `master`
5959
8. Link the pull request to the according GitHub issue and set the label accordingly
6060

61-
**NOTE:** For support while developing you can use little helper scripts, see [git-hooks](https://github.com/eclipse-iceoryx/iceoryx/blob/master/tools/git-hooks/Readme.md).
61+
**NOTE:** For support while developing you can use little helper scripts, see [git-hooks](https://github.com/eclipse-iceoryx/iceoryx/blob/v2.0.0/tools/git-hooks/Readme.md).
6262

6363
## Branching strategy
6464

@@ -115,7 +115,7 @@ codebase follows these rules, things are work in progress.
115115
shall not be propagated via an `iox::cxx::expected`
116116
9) **Not more than two-level nested namespaces**, three-level nested namespace can be used sparsely
117117

118-
See [error-handling.md](https://github.com/eclipse-iceoryx/iceoryx/blob/master/doc/design/error-handling.md) for additional
118+
See [error-handling.md](https://github.com/eclipse-iceoryx/iceoryx/blob/v2.0.0/doc/design/error-handling.md) for additional
119119
information about logging and error handling.
120120

121121
### Naming conventions

NOTICE.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ The project maintains the following source code repositories:
3131
## Third-party Dependencies
3232

3333
This project leverages the following third party content.
34-
The corresponding license files can be found at <https://github.com/eclipse-iceoryx/iceoryx/tree/master/doc/3rd_party_licenses> or in the folder `share/doc/iceoryx/3rd_party_licenses` of your local iceoryx installation.
34+
The corresponding license files can be found at <https://github.com/eclipse-iceoryx/iceoryx/tree/v2.0.0/doc/3rd_party_licenses> or in the folder `share/doc/iceoryx/3rd_party_licenses` of your local iceoryx installation.
3535

3636
### System Libraries
3737

QUALITY_DECLARATION.md

+21-21
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ The packages `iceoryx_hoofs`, `iceoryx_posh` and `iceoryx_binding_c` claim to be
66

77
Below are the rationales, notes, and caveats for this claim, organized by each requirement listed in the [Package Requirements for Quality Level 2 in REP-2004](https://www.ros.org/reps/rep-2004.html).
88

9-
See the [Readme](https://github.com/eclipse-iceoryx/iceoryx#quality-levels--platforms) for a full list of the quality levels of iceoryx components and [Contributing Guide](https://github.com/eclipse-iceoryx/iceoryx/blob/master/CONTRIBUTING.md#quality-levels) for a description of the quality levels.
9+
See the [Readme](https://github.com/eclipse-iceoryx/iceoryx#quality-levels--platforms) for a full list of the quality levels of iceoryx components and [Contributing Guide](https://github.com/eclipse-iceoryx/iceoryx/blob/v2.0.0/CONTRIBUTING.md#quality-levels) for a description of the quality levels.
1010

1111
## Version Policy [1]
1212

@@ -17,13 +17,13 @@ Changes for MINOR releases are API compatible and ideally ABI stable if not clea
1717

1818
A similar format is prescribed by the Eclipse Foundation in the [Release Handbook](https://www.eclipse.org/projects/handbook/#release).
1919

20-
On Git, the tags have a `v` prefix before the version numbers. A [release script](https://github.com/eclipse-iceoryx/iceoryx/blob/master/tools/scripts/iceoryx_release.sh) shall ensure that version numbers are kept consistent for all packages.
20+
On Git, the tags have a `v` prefix before the version numbers. A [release script](https://github.com/eclipse-iceoryx/iceoryx/blob/v2.0.0/tools/scripts/iceoryx_release.sh) shall ensure that version numbers are kept consistent for all packages.
2121

2222
### Version Stability [1.ii]
2323

2424
Since release `1.0.0` iceoryx is at a stable version, i.e. `>= 1.0.0`. The latest valid release can be found on the [release page](https://github.com/eclipse-iceoryx/iceoryx/releases) of iceoryx.
2525

26-
The change history can be found in the [release notes section](https://iceoryx.io/latest/release-notes).
26+
The change history can be found in the [release notes section](https://iceoryx.io/v2.0.0/release-notes).
2727

2828
### Public API Declaration [1.iii]
2929

@@ -55,8 +55,8 @@ It is planned to build and test the changes on the ROS CI for early detection of
5555

5656
### Change Requests [2.i]
5757

58-
All changes in the codebase require a Pull-Request. It is mandatory to link the Pull-Request to a corresponding [issue ticket](https://github.com/eclipse-iceoryx/iceoryx/blob/master/CONTRIBUTING.md#feature-request-and-bugs) on GitHub to ensure traceability.
59-
The contributor and reviewer are required to fill out a [Pull-Request Template](https://github.com/eclipse-iceoryx/iceoryx/blob/master/.github/PULL_REQUEST_TEMPLATE.md) before merging.
58+
All changes in the codebase require a Pull-Request. It is mandatory to link the Pull-Request to a corresponding [issue ticket](https://github.com/eclipse-iceoryx/iceoryx/blob/v2.0.0/CONTRIBUTING.md#feature-request-and-bugs) on GitHub to ensure traceability.
59+
The contributor and reviewer are required to fill out a [Pull-Request Template](https://github.com/eclipse-iceoryx/iceoryx/blob/v2.0.0/.github/PULL_REQUEST_TEMPLATE.md) before merging.
6060

6161
### Contributor Origin [2.ii]
6262

@@ -89,13 +89,13 @@ It is required to create/modify the Doxygen/design and user documentation within
8989

9090
### Feature Documentation [3.i]
9191

92-
The documentation of the main iceoryx features (sending, receiving data) can be found in the [overview](https://iceoryx.io/latest/getting-started/overview/) and [iceoryx examples](https://iceoryx.io/latest/getting-started/examples/) including a user-friendly description on how to use the iceoryx API.
93-
The [configuration guide](https://iceoryx.io/latest/advanced/configuration-guide/) completes the documentation on how to use iceoryx.
92+
The documentation of the main iceoryx features (sending, receiving data) can be found in the [overview](https://iceoryx.io/v2.0.0/getting-started/overview/) and [iceoryx examples](https://iceoryx.io/v2.0.0/getting-started/examples/) including a user-friendly description on how to use the iceoryx API.
93+
The [configuration guide](https://iceoryx.io/v2.0.0/advanced/configuration-guide/) completes the documentation on how to use iceoryx.
9494

95-
Detailed technical documentation about iceoryx features can be found in the [design document](https://github.com/eclipse-iceoryx/iceoryx/tree/master/doc/design) section with descriptions and diagrams about internal mechanisms of iceoryx.
95+
Detailed technical documentation about iceoryx features can be found in the [design document](https://github.com/eclipse-iceoryx/iceoryx/tree/v2.0.0/doc/design) section with descriptions and diagrams about internal mechanisms of iceoryx.
9696

97-
For new features, it is recommended to first create a design document, see the [Contribution Guidelines](https://github.com/eclipse-iceoryx/iceoryx/blob/master/CONTRIBUTING.md#feature-request-and-bugs) for more information.
98-
Diagrams in feature descriptions need to be consistently generated with [PlantUML](https://github.com/eclipse-iceoryx/iceoryx/tree/master/doc/design#design-documents).
97+
For new features, it is recommended to first create a design document, see the [Contribution Guidelines](https://github.com/eclipse-iceoryx/iceoryx/blob/v2.0.0/CONTRIBUTING.md#feature-request-and-bugs) for more information.
98+
Diagrams in feature descriptions need to be consistently generated with [PlantUML](https://github.com/eclipse-iceoryx/iceoryx/tree/v2.0.0/doc/design#design-documents).
9999

100100
Currently there is ongoing work to complete the documentation of existing features to reach quality level 1.
101101

@@ -106,32 +106,32 @@ The public API is documented in form of Doxygen comments and available as API re
106106
### License [3.iii]
107107

108108
The license for Eclipse iceoryx is the Apache License 2.0, and each code file includes a license statement.
109-
The full license text is available in the [`LICENSE`](https://github.com/eclipse-iceoryx/iceoryx/blob/master/LICENSE) file.
110-
The project includes a [`NOTICE`](https://github.com/eclipse-iceoryx/iceoryx/blob/master/NOTICE.md) with links to more information about these licenses.
109+
The full license text is available in the [`LICENSE`](https://github.com/eclipse-iceoryx/iceoryx/blob/v2.0.0/LICENSE) file.
110+
The project includes a [`NOTICE`](https://github.com/eclipse-iceoryx/iceoryx/blob/v2.0.0/NOTICE.md) with links to more information about these licenses.
111111

112112
There is some third-party content included with Eclipse iceoryx which is licensed as MIT or New BSD.
113-
Details can also be found in the included [`NOTICE`](https://github.com/eclipse-iceoryx/iceoryx/blob/master/NOTICE.md#third-party-dependencies) document.
113+
Details can also be found in the included [`NOTICE`](https://github.com/eclipse-iceoryx/iceoryx/blob/v2.0.0/NOTICE.md#third-party-dependencies) document.
114114

115115
### Copyright Statement [3.iv]
116116

117-
Each source code file in Eclipse iceoryx has a copyright header that needs to follow this [style](https://github.com/eclipse-iceoryx/iceoryx/blob/master/CONTRIBUTING.md#header).
117+
Each source code file in Eclipse iceoryx has a copyright header that needs to follow this [style](https://github.com/eclipse-iceoryx/iceoryx/blob/v2.0.0/CONTRIBUTING.md#header).
118118

119119
A CI job ensures by checking with `ament_copyright` that all files comply with this rule.
120120

121121
## Testing [4]
122122

123-
Every iceoryx package has a `test` folder that contains subfolders for [module- and/or integrationtests](https://github.com/eclipse-iceoryx/iceoryx/blob/master/CONTRIBUTING.md#testing) written based on the Google test framework. All tests are running on the CI for every Pull-Request for all supported platforms and are contained in the master branch.
123+
Every iceoryx package has a `test` folder that contains subfolders for [module- and/or integrationtests](https://github.com/eclipse-iceoryx/iceoryx/blob/v2.0.0/CONTRIBUTING.md#testing) written based on the Google test framework. All tests are running on the CI for every Pull-Request for all supported platforms and are contained in the master branch.
124124
Currently, due to limited support on Windows, there are some exclusions for testing on the CI.
125125

126126
### Feature Testing [4.i]
127127

128-
The features of iceoryx are tested in the [iceoryx_integrationtest](https://github.com/eclipse-iceoryx/iceoryx/tree/master/iceoryx_integrationtest) package. Using `launch_test`, tests are executed on system-level to ensure that the iceoryx packages are functional and the Public API works according to specification.
128+
The features of iceoryx are tested in the [iceoryx_integrationtest](https://github.com/eclipse-iceoryx/iceoryx/tree/v2.0.0/iceoryx_integrationtest) package. Using `launch_test`, tests are executed on system-level to ensure that the iceoryx packages are functional and the Public API works according to specification.
129129
There is continuous effort to cover the corner cases in the usage of iceoryx in test-cases.
130130

131131
### Public API Testing [4.ii]
132132

133133
All tests are executed for every major feature. New features must provide unit and integration tests that cover the code changes in the Pull-Request. The tests reside in separated folders for every package following a defined structure and naming convention.
134-
The features are tested at module(unit) -integration and system test level. The [guidelines](https://iceoryx.io/latest/advanced/best-practice-for-testing/) for Contributors ensure a high quality of test development.
134+
The features are tested at module(unit) -integration and system test level. The [guidelines](https://iceoryx.io/v2.0.0/advanced/best-practice-for-testing/) for Contributors ensure a high quality of test development.
135135

136136
### Coverage [4.iii]
137137

@@ -142,14 +142,14 @@ The Eclipse iceoryx project use [gcov](https://gcc.gnu.org/onlinedocs/gcc/Gcov.h
142142
- Branch Coverage
143143

144144
The coverage results of every Pull-Request and master branch are publicly available on [codecov.io](https://app.codecov.io/gh/eclipse-iceoryx/iceoryx).
145-
A detailed report (e.g. the coverage in different packages) can be obtained by following [this](https://github.com/eclipse-iceoryx/iceoryx/blob/master/CONTRIBUTING.md#coverage-scan) guide.
145+
A detailed report (e.g. the coverage in different packages) can be obtained by following [this](https://github.com/eclipse-iceoryx/iceoryx/blob/v2.0.0/CONTRIBUTING.md#coverage-scan) guide.
146146

147147
### Performance [4.iv]
148148

149149
The most important measurement units for performance testing on iceoryx are the data transfer latency and the CPU load incurred by passing data.
150150
They can be obtained in two ways:
151151

152-
1. [iceperf](https://github.com/eclipse-iceoryx/iceoryx/tree/master/iceoryx_examples/iceperf#iceperf)
152+
1. [iceperf](https://github.com/eclipse-iceoryx/iceoryx/tree/v2.0.0/iceoryx_examples/iceperf#iceperf)
153153
This performance test uses the iceoryx API directly without any indirections to compare different IPC mechanisms on increasing payload sizes.
154154
The output is a table showing various payload sizes with their corresponding latency in microseconds.
155155

@@ -162,10 +162,10 @@ Currently, there are no automatic regression tests in the CI running. The work t
162162

163163
### Linters and Static Analysis [4.v]
164164

165-
The code formatting is enforced through the CI using `clang-format` and can be used by following this [guide](https://github.com/eclipse-iceoryx/iceoryx/blob/master/CONTRIBUTING.md#coding-style)
165+
The code formatting is enforced through the CI using `clang-format` and can be used by following this [guide](https://github.com/eclipse-iceoryx/iceoryx/blob/v2.0.0/CONTRIBUTING.md#coding-style)
166166

167167
The codebase is checked with `clang-tidy` to enforce naming conventions and basic coding rules and checked in the Pull-Requests by review.
168-
A [static code analysis](https://github.com/eclipse-iceoryx/iceoryx/blob/master/CONTRIBUTING.md#static-code-analysis) is done regularly with the Axivion Suite, but the results are not publicly accessible due to licensing.
168+
A [static code analysis](https://github.com/eclipse-iceoryx/iceoryx/blob/v2.0.0/CONTRIBUTING.md#static-code-analysis) is done regularly with the Axivion Suite, but the results are not publicly accessible due to licensing.
169169

170170
## Dependencies [5]
171171

doc/aspice_swe3_4/swe_docu_guidelines.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,7 @@ Generally, you will not find any Doxygen file in our repo because we let CMake g
9393
In [Cmake](CMakeLists.txt) is the command `doxygen_add_docs` which does the job.
9494
There, we are also setting some parameters and the aliases for the custom tags. Aliases with an `xrefitem` create a page where all occurrences of the corresponding tag are collected.
9595
### file header
96-
Please see [Header](https://github.com/eclipse-iceoryx/iceoryx/blob/master/CONTRIBUTING.md#header).
96+
Please see [Header](https://github.com/eclipse-iceoryx/iceoryx/blob/v2.0.0/CONTRIBUTING.md#header).
9797

9898
### Include guards
9999
Every header and inl file needs to have an include guard. Pragma once is not allowed.

doc/design/README.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ A good online-editor with cheat-sheet can be found at [https://plantuml-editor.k
1919
Alternatively you can use extensions in your IDE.
2020

2121
The integration of the generated PlantUML into your design documents is done via *.svg files.
22-
You need to create a .puml file and export it to .svg afterwards for linking it with the markdown. In the `tools` folder is a [helper script](https://github.com/eclipse-iceoryx/iceoryx/blob/master/tools/scripts/generate_plantuml_svg.sh) provided which downloads a defined version of PlantUML to export the vector graphics.
22+
You need to create a .puml file and export it to .svg afterwards for linking it with the markdown. In the `tools` folder is a [helper script](https://github.com/eclipse-iceoryx/iceoryx/blob/v2.0.0/tools/scripts/generate_plantuml_svg.sh) provided which downloads a defined version of PlantUML to export the vector graphics.
2323
These steps are necessary due to the current support of PlantUML in [Github](https://github.community/t/support-uml-diagrams-in-markdown-with-plantuml-syntax/626).
2424

2525
**NOTE:** Don't set parameter for theming (like background color) directly in individual puml files but use the central `doc/iceoryx-plantuml-config.puml` which is shared with all diagrams.

doc/shared-memory-communication.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ The number of segments used by an iceoryx system, along with the configuration o
4848
provided to the system via configuration.
4949

5050
The configuration can be provided at compile time (as a header) or at runtime (as a toml-formatted text file).
51-
See the [configuration guide](https://github.com/eclipse-iceoryx/iceoryx/blob/master/doc/website/advanced/configuration-guide.md#configuring-mempools-for-roudi) for more details.
51+
See the [configuration guide](https://github.com/eclipse-iceoryx/iceoryx/blob/v2.0.0/doc/website/advanced/configuration-guide.md#configuring-mempools-for-roudi) for more details.
5252

5353
## Zero-copy communication
5454

doc/website/.pages

-1
Original file line numberDiff line numberDiff line change
@@ -7,4 +7,3 @@ nav:
77
- FAQ.md
88
- advanced
99
- release-notes
10-
- API-reference

doc/website/FAQ.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ In this document are tips and hints documented which can help for troubleshootin
44

55
## Does iceoryx run in a docker environment
66

7-
Yes. Take a look at the [icedocker example](https://github.com/eclipse-iceoryx/iceoryx/blob/master/iceoryx_examples/icedelivery)
7+
Yes. Take a look at the [icedocker example](https://github.com/eclipse-iceoryx/iceoryx/blob/v2.0.0/iceoryx_examples/icedocker)
88

99
## iox-roudi fails on startup
1010

@@ -99,4 +99,4 @@ docker run -it --shm-size="2g" ubuntu
9999
To avoid undefined behavior of iceoryx posh it is recommended to terminate RouDi and the corresponding middleware
100100
processes with SIGINT or SIGTERM. In RouDi, we have integrated a sighandler that catches the signals and gives RouDi
101101
the chance to exit and clean-up everything. This also applies for processes. Therefore, we recommend adding a signalhandler
102-
to your process (see [this example](https://github.com/eclipse-iceoryx/iceoryx/blob/master/iceoryx_examples/icedelivery/iox_publisher_untyped.cpp)).
102+
to your process (see [this example](https://github.com/eclipse-iceoryx/iceoryx/blob/v2.0.0/iceoryx_examples/icedelivery/iox_publisher_untyped.cpp)).

doc/website/advanced/configuration-guide.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ These options adjust the limits of Publisher and Subscriber Ports for resource m
1515
| `IOX_MAX_CHUNKS_HELD_PER_SUBSCRIBER_SIMULTANEOUSLY` | Maximum number of chunks a subscriber can hold at a given time (subscriber history size)|
1616
| `IOX_MAX_INTERFACE_NUMBER` | Maximum number of interface ports which are used for gateways |
1717

18-
Have a look at [iceoryx_posh_deployment.cmake](https://github.com/eclipse-iceoryx/iceoryx/blob/master/iceoryx_posh/cmake/iceoryx_posh_deployment.cmake) for the default values of the constants.
18+
Have a look at [IceoryxPoshDeployment.cmake](https://github.com/eclipse-iceoryx/iceoryx/blob/v2.0.0/iceoryx_posh/cmake/IceoryxPoshDeployment.cmake) for the default values of the constants.
1919

2020
!!! hint
2121
With the default values set, the size of `iceoryx_mgmt` is ~64.5 MByte. You can reduce the size by decreasing the values from the table via the CMake options. The current values are printed in the CMake stage when building iceoryx.
@@ -142,12 +142,12 @@ size = 1024
142142
count = 100
143143
```
144144

145-
When no config file is specified, a hard-coded version similar to the [default config](https://github.com/eclipse-iceoryx/iceoryx/blob/master/iceoryx_posh/etc/iceoryx/roudi_config_example.toml) will be used.
145+
When no config file is specified, a hard-coded version similar to the [default config](https://github.com/eclipse-iceoryx/iceoryx/blob/v2.0.0/iceoryx_posh/etc/iceoryx/roudi_config_example.toml) will be used.
146146

147147
### Static configuration
148148

149149
Another way is to have a static config that is compile-time dependent, this means that you have to recompile your RouDi application if you want to change your config (not the iceoryx_posh_roudi lib).
150150
You can have your source file with `main()` method where you can create your custom configuration and pass it to a RouDi instantiation.
151151
In your CMake file for your custom RouDi you need to ensure that it is **not** linking against `iceoryx_posh_config` to have a static config.
152152

153-
A good example of a static config can be found [here](https://github.com/eclipse-iceoryx/iceoryx/blob/master/iceoryx_examples/iceperf/roudi_main_static_config.cpp).
153+
A good example of a static config can be found [here](https://github.com/eclipse-iceoryx/iceoryx/blob/v2.0.0/iceoryx_examples/iceperf/roudi_main_static_config.cpp).

0 commit comments

Comments
 (0)