Skip to content

Latest commit

 

History

History
67 lines (40 loc) · 2.26 KB

UPDATE_PROCEDURE.md

File metadata and controls

67 lines (40 loc) · 2.26 KB
Raw

Natural Earth Update Procedure

Scripts to build Natural Earth ZIP archives for individual themes, scalesets, and packagages.

NOTE: Individual Pull Requests should not include running these steps, it'll create merge conflicts between different binary files (some of which are no longer tracked in the repository because of Github.com changes).

Requirements:

  • Make a generic Unix utility, to be installed.
  • GDAL to be installed and the folder containing ogr2ogr to be added to the PATH environment variable

Assumed to be run on Mac or Ubuntu Linux.

Usage

  1. Increment the VERSION number, per the semantic versioning guidelines at ../README.md:

     pico VERSION

  2. Update the CHANGELOG with the new edits.

     pico CHANGELOG

    Note: You'll likely want to edit the CHANGELOG in a real text editor. Those changes should also be recorded, with better formatting, in a public blog post.

  3. Formalize the new version in Git by setting a tag:

     git tag  -m 'See CHANGELOG for details.' -a v`cat VERSION`

  4. Package those changes for distribution by running one of the make targets:

     make all

    Other common, more specific targets include:

     make zips/10m_cultural/10m_cultural.zip
 make zips/10m_physical/10m_physical.zip
 make zips/50m_cultural/50m_cultural.zip
 make zips/50m_physical/50m_physical.zip
 make zips/110m_cultural/110m_cultural.zip
 make zips/110m_physical/110m_physical.zip
 make zips/packages/natural_earth_vector.zip
 make zips/packages/Natural_Earth_quick_start/Natural_Earth_quick_start.zip
 make clean

    Note, that if this is a clean clone or checkout you should start with the following, since 'clean' creates the required empty directories:

     make clean all

  5. Push those changes live to the distribution network!

     make live

  6. Updated Drainholes on the distribution server:

     http://naturalearthdata.com/blog/wp-admin/

  7. Write the blog post announcing the changes (parallels the CHANGELOG above).

     http://naturalearthdata.com/blog/wp-admin/

  8. Send email to update list announcing the changes and directing them to the blog post.

     http://naturalearthdata.com/updates/