Throughout this document, replace $OLD_VERSION with the previous release and $NEW_VERSION with the next one. Versions should start with a v, e.g. v2.40.0
.
- Update your local master branch
- Review the changes in git since the last release with a command like
git log --graph $OLD_VERSION...master
or online at https://github.com/gravitystorm/openstreetmap-carto/compare/$OLD_VERSION...master - Review pull requests for anything that should be merged before release
- Check
preview.png
and update it if needed. Preferred way is to import current Chicago data, export new image (for example from Kosmtik via this link) and upload as new version of this file
Decide among the maintainers if a new release is due.
- Check out master with git
- Change the Unreleased section in
CHANGELOG.md
to the new version. Add any changes that are missing from the changelog and a new Unreleased section. - Commit the changelog changes and tag a release with
git tag -a $NEW_VERSION -m "Tag $NEW_VERSION"
. Optional: Add-s
and GPG sign the tag. - Push the tag with
git push origin $NEW_VERSION
. If you use a different name for the gravitystorm/openstreetmap-carto remote, use it instead. - If there are any long-running development branches check them out and merge the new release with
git merge $NEW_RELEASE
.
-
Notify OSMF tile server admins with an issue on OpenStreetMap Chef. Add any deployment-related changes like new shapefiles or font changes to the ticket.
-
Write an email to [email protected] and [email protected] with the subject "OpenStreetMap Carto release $NEW_VERSION" and the body
Dear all,
Today, $NEW_VERSION of the OpenStreetMap Carto stylesheet (the default
stylesheet on the OSM website) has been released. Once changes are deployed
on the openstreetmap.org it will take couple of days before all tiles
show the new rendering.
If the tile server admins have rolled out the new version, change it to:
Today, $NEW_VERSION of the OpenStreetMap Carto stylesheet (the default
stylesheet on the OSM website) has been released and rolled out
to the openstreetmap.org servers. It might take a couple of days
before all tiles show the new rendering.
Changes include
*A list of changes*
Thanks to all the contributors for this release.
If there are new contributors, add
including <name>, <name>, [a] new contributor[s].
If there has been a major PR merged, additional thanks can be added
For a full list of commits, see
https://github.com/gravitystorm/openstreetmap-carto/compare/$OLD_VERSION...$NEW_VERSION
As always, we welcome any bug reports at
https://github.com/gravitystorm/openstreetmap-carto/issues
-
Post an openstreetmap.org diary entry with the text from the email. Add links and other markdown if needed.
-
Optional: Post on twitter with a link to the diary entry.