natural-earth-vector/UPDATE_PROCEDURE.md
2012-06-07 17:32:54 -07:00

56 lines
1.7 KiB
Markdown

#Natural Earth Update Procedure
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.
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
6. Push those changes live to the distribution network!
make live
7. Updated Drainholes on the distribution server:
http://naturalearthdata.com/blog/wp-admin/
8. Write the blog post announcing the changes (parallels the CHANGELOG above).
http://naturalearthdata.com/blog/wp-admin/
9. Send email to update list announcing the changes and directing them to the blog post.
http://naturalearthdata.com/updates/