mapbox/tilemill — Issue #1322: Further documentation for how to "Save As..." and versioning
Author: mroswell
Created: 2012-02-24 20:31:03+00:00
State: open

Issue #67 has been closed, along with a number of duplicate issues , but I think a few bits of documentation are required for this to actually work.

I've prepared draft documentation below. Is this accurate?

(Furthermore,
- when I upload to MapBox, what needs to be modified in order not to overwrite a previous file?
Is it the "name" item documented below that controls the filename on MapBox?
- can anyone help with a semver tutorial?
I don't honestly know what to do with http://semver.org/ and the related MapBox field.
)

Now that my map of the House Committee on Agriculture ( http://www.MargieRoswell.com/maps ) is out there in the real world, and people are requesting tweaks to it, I really want to have a good handle on versioning.

Proposed Documentation - Please review for accuracy:

How to "Save As..." in TileMill

1. Copy the /MapBox/Project/projectname to another directory under Project

Now you'll have both
MapBox/Project/ProjectName
and
MapBox/Project/NewProjectName

2. Rename
MapBox/Project/projectname/ProjectName.mml
to
MapBox/Project/NewProjectName/NewProjectName.mml

3. EditNewProjectName.mml, changing the following line to reflect the new project name:

"project": "ProjectName",

4. Also Change:
"name": "ProjectName",

to:
"name": "NewProjectName",
or something like:
"name": "Project Name V.2"

Note that if you edit the original GIS file, it'll edit the underlying data being used by both projects, since they're referencing the same directory. You may choose a different data source for the new project, to ensure that the original map is not modified.