You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- CHANGED: Docker build, enabled apt-get update/install caching in separate layer for build phase [#6175](https://github.com/Project-OSRM/osrm-backend/pull/6175)
184
188
- FIXED: Bump CI complete meta job to ubuntu-20.04 [#6323](https://github.com/Project-OSRM/osrm-backend/pull/6323)
185
-
- CHANGED: Node packages are now scoped by @project-osrm[#6386](https://github.com/Project-OSRM/osrm-backend/issues/6386)
189
+
- CHANGED: Node packages are now scoped by \@project-osrm [#6386](https://github.com/Project-OSRM/osrm-backend/issues/6386)
186
190
- Routing:
187
191
- CHANGED: Lazily generate optional route path data [#6045](https://github.com/Project-OSRM/osrm-backend/pull/6045)
188
192
- FIXED: Completed support for no_entry and no_exit turn restrictions. [#5988](https://github.com/Project-OSRM/osrm-backend/pull/5988)
@@ -217,7 +221,7 @@
217
221
- Build:
218
222
- CHANGED: Node binaries now use Github Releases for hosting [#6030](https://github.com/Project-OSRM/osrm-backend/pull/6030)
219
223
- Misc:
220
-
- FIXED: Upgrade to @mapbox/node-pre-gyp fix various bugs with Node 12/14 [#5991](https://github.com/Project-OSRM/osrm-backend/pull/5991)
224
+
- FIXED: Upgrade to \@mapbox/node-pre-gyp fix various bugs with Node 12/14 [#5991](https://github.com/Project-OSRM/osrm-backend/pull/5991)
221
225
- FIXED: `valid` type in documentation examples [#5990](https://github.com/Project-OSRM/osrm-backend/issues/5990)
222
226
- FIXED: Remove redundant loading of .osrm.cell_metrics [#6019](https://github.com/Project-OSRM/osrm-backend/issues/6019)
223
227
- CHANGED: Increase PackedOSMIDs size to 34 bits. This breaks the **data format**[#6020](https://github.com/Project-OSRM/osrm-backend/issues/6020)
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+16-13Lines changed: 16 additions & 13 deletions
Original file line number
Diff line number
Diff line change
@@ -1,18 +1,21 @@
1
-
# Everyone
1
+
# Contributing
2
+
3
+
## Everyone
2
4
3
5
Please take some time to review our [code of conduct](CODE-OF-CONDUCT.md) to help guide your interactions with others on this project.
4
6
5
-
# User
7
+
##User
6
8
7
9
Before you open a new issue, please search for older ones that cover the same issue.
8
10
In general "me too" comments/issues are frowned upon.
9
11
You can add a :+1: emoji reaction to the issue if you want to express interest in this.
10
12
11
-
# Developer
13
+
##Developer
12
14
13
15
We use `clang-format` version `15` to consistently format the code base. There is a helper script under `scripts/format.sh`.
14
16
The format is automatically checked by the `mason-linux-release` job of a Travis CI build.
15
17
To save development time a local hook `.git/hooks/pre-push`
18
+
16
19
```
17
20
#!/bin/sh
18
21
@@ -28,16 +31,16 @@ if [ x"$remote" = xorigin ] ; then
28
31
fi
29
32
fi
30
33
```
34
+
31
35
could check code format, modify a local repository and reject push due to unstaged formatting changes.
32
-
Also `pre-push` hook rejects direct pushes to `origin/master`.
36
+
Also `pre-push` hook rejects direct pushes to `origin/master`.
33
37
34
38
⚠️ `scripts/format.sh` checks all local files that match `*.cpp` or `*.hpp` patterns.
35
39
36
-
37
40
In general changes that affect the API and/or increase the memory consumption need to be discussed first.
38
41
Often we don't include changes that would increase the memory consumption a lot if they are not generally usable (e.g. elevation data is a good example).
39
42
40
-
## Pull Request
43
+
###Pull Request
41
44
42
45
Every pull-request that changes the API needs to update the docs in `docs/http.md` and add an entry to `CHANGELOG.md`.
43
46
Breaking changes need to have a BREAKING prefix. See the [releasing documentation](docs/releasing.md) on how this affects the version.
@@ -57,25 +60,25 @@ If you do have commit access there are in general two accepted styles to merging
57
60
58
61
1. Make sure the branch is up to date with `master`. Run `git rebase master` to find out.
59
62
2. Once that is ensured you can either:
60
-
- Click the nice green merge button (for a non-fast-forward merge)
61
-
- Merge by hand using a fast-forward merge
63
+
64
+
- Click the nice green merge button (for a non-fast-forward merge)
65
+
- Merge by hand using a fast-forward merge
62
66
63
67
Which merge you prefer is up to personal preference. In general it is recommended to use fast-forward merges because it creates a history that is sequential and easier to understand.
64
68
65
-
# Maintainer
69
+
##Maintainer
66
70
67
-
## Doing a release
71
+
###Doing a release
68
72
69
73
There is an in-depth guide around how to push out a release once it is ready [here](docs/releasing.md).
70
74
71
-
## The API
75
+
###The API
72
76
73
77
Changes to the API need to be discussed and signed off by the team. Breaking changes even more so than additive changes.
74
78
75
-
## Milestones
79
+
###Milestones
76
80
77
81
If a pull request or an issue is applicable for the current or next milestone, depends on the target version number.
78
82
Since we use semantic versioning we restrict breaking changes to major releases.
79
83
After a Release Candidate is released we usually don't change the API anymore if it is not critical.
80
84
Bigger code changes after a RC was released should also be avoided.
High performance routing engine written in C++ designed to run on OpenStreetMap data.
7
6
8
7
The following services are available via HTTP API, C++ library interface and NodeJs wrapper:
8
+
9
9
- Nearest - Snaps coordinates to the street network and returns the nearest matches
10
10
- Route - Finds the fastest route between coordinates
11
11
- Table - Computes the duration or distances of the fastest route between all pairs of supplied coordinates
@@ -18,6 +18,7 @@ To quickly try OSRM use our [demo server](http://map.project-osrm.org) which com
18
18
For a quick introduction about how the road network is represented in OpenStreetMap and how to map specific road network features have a look at [the OSM wiki on routing](https://wiki.openstreetmap.org/wiki/Routing) or [this guide about mapping for navigation](https://web.archive.org/web/20221206013651/https://labs.mapbox.com/mapping/mapping-for-navigation/).
19
19
20
20
Related [Project-OSRM](https://github.com/Project-OSRM) repositories:
21
+
21
22
-[osrm-frontend](https://github.com/Project-OSRM/osrm-frontend) - User-facing frontend with map. The demo server runs this on top of the backend
22
23
-[osrm-text-instructions](https://github.com/Project-OSRM/osrm-text-instructions) - Text instructions from OSRM route response
23
24
-[osrm-backend-docker](https://github.com/project-osrm/osrm-backend/pkgs/container/osrm-backend) - Ready to use Docker images
@@ -40,6 +41,7 @@ Related [Project-OSRM](https://github.com/Project-OSRM) repositories:
40
41
The easiest and quickest way to setup your own routing engine is to use Docker images we provide.
41
42
42
43
There are two pre-processing pipelines available:
44
+
43
45
- Contraction Hierarchies (CH)
44
46
- Multi-Level Dijkstra (MLD)
45
47
@@ -85,13 +87,13 @@ After adding yourself to the `docker` group make sure to log out and back in aga
85
87
86
88
We support the following images in the Container Registry:
87
89
88
-
Name | Description
89
-
-----|------
90
-
`latest` | `master` compiled with release flag
91
-
`latest-assertions` | `master` compiled with with release flag, assertions enabled and debug symbols
92
-
`latest-debug` | `master` compiled with debug flag
93
-
`<tag>` | specific tag compiled with release flag
94
-
`<tag>-debug` | specific tag compiled with debug flag
0 commit comments