natural-earth-vector/UPDATE_PROCEDURE.md
2012-06-07 14:17:15 -07:00

1.6 KiB

#About

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

Requirements: Make a generic Unix utility, to be installed.

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.

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

     git tag  -m 'See CHANGELOG for details.' -a `cat ../VERSION`
    
  2. 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
  1. Push those changes live to the distribution network!

     make live
    
  2. Write the blog post announcing the changes (parallels the ../CHANGELOG above).

     http://naturalearthdata.com/blog/
    
  3. Send email to update list announcing the changes and directing them to the blog post.

     http://naturalearthdata.com/updates/