natural-earth-vector/UPDATE_PROCEDURE.md

52 lines
1.6 KiB
Markdown
Raw Normal View History

2012-06-06 18:34:22 -07:00
#About
2012-06-07 14:04:48 -07:00
Scripts to build Natural Earth ZIP archives for individual themes, scalesets, and packagages.
2012-06-06 18:34:22 -07:00
2012-06-07 14:04:48 -07:00
**Requirements**: `Make` a generic Unix utility, to be installed.
2012-06-06 18:34:22 -07:00
2012-06-07 14:04:48 -07:00
Assumed to be run on Mac or Ubuntu Linux.
2012-06-06 18:34:22 -07:00
#Usage
2012-06-07 14:04:48 -07:00
1. Increment the VERSION number, per the semantic versioning guidelines at ../README.md:
2012-06-06 18:34:22 -07:00
2012-06-07 14:04:48 -07:00
pico ../VERSION
2. Update the CHANGELOG with the new edits.
pico ../CHANGELOG
2012-06-07 14:19:54 -07:00
Note: You'll likely want to edit the CHANGELOG in a real text editor. Those changes should
2012-06-07 14:04:48 -07:00
also be recorded, with better formatting, in a public blog post.
2012-06-06 18:34:22 -07:00
2012-06-07 14:04:48 -07:00
3. Formalize the new version in Git by setting a tag:
git tag -m 'See CHANGELOG for details.' -a `cat ../VERSION`
2012-06-06 18:34:22 -07:00
2012-06-07 14:04:48 -07:00
4. Package those changes for distribution by running one of the make targets:
make all
2012-06-06 18:34:22 -07:00
2012-06-07 14:19:54 -07:00
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
2012-06-07 14:04:48 -07:00
6. Push those changes live to the distribution network!
make live
7. Write the blog post announcing the changes (parallels the ../CHANGELOG above).
http://naturalearthdata.com/blog/
8. Send email to update list announcing the changes and directing them to the blog post.
http://naturalearthdata.com/updates/