How to Contribute
This is a community project open to collaboration. To maintain data integrity, contributors must follow the correct process. While we follow much of the methodology of the National Zoning Atlas, we deviate in various ways to best reflect Vermont zoning practices. Follow the information below to contribute, and reference the Data page for guidance on field values and practices.
Explore HOW TO MAKE A ZONING ATLAS, a guide with step-by-step instructions about how to list zoning districts, analyze zoning code texts, and collect and upload geospatial information.
License
This project is under the MIT license. We welcome contributions with the understanding you are submitting them under that license. You are welcome to use, fork and explore this data — that is the point of it!
Pull Requests
All changes should be submitted as a pull request in GitHub. Pull requests updating the data should include a description of what has changed and links to supporting documents. We recommend a limited number of changes at a time to make this a reasonable process for everyone.
Updating a Jurisdiction
Updating a jurisdiction's zoning data will require using ArcGIS Pro or another GIS software. This guide will show you how to use ArcGIS Pro for this process.
Step 1: Downloading the Data
The first step is to download the data from this repository. From the main Vermont Zoning Atlas page, open the "Data" folder and find the "RPC" folder. Download the regional file (.geojson) that contains your jurisdiction. If you're unsure which RPC your jurisdiction belongs to, you can check the RPC guide or search online.
Step 2: Opening the Data in ArcGIS Pro
After downloading the RPC .geojson file:
- Open ArcGIS Pro and create a new project
- Open the geoprocessing window
- Search for "JSON to Features" tool
- Use this tool to convert your downloaded .geojson file, naming the output feature class something like "VT_Zoning"
Note: The resulting feature class will be in the coordinate system "WGS 1984". If you plan to change geometries, you should project this to "NAD 1983 StatePlane Vermont FIPS 4400 (Meters)" using the "Project" tool. Search for coordinate system code "32145" for easy access. Skip this step if you're only modifying the attribute table.
Step 3: Exporting Your Jurisdiction
To isolate your jurisdiction for editing:
- Use "Select by Attributes" to filter where Jurisdiction equals your target jurisdiction
- Right-click the layer, hover "Data", and click "Export Features"
- Name the output feature class after your jurisdiction
- Verify your selection shows the correct number of districts at the bottom of the screen
Step 4: Editing Jurisdiction Data
Coordinate System: Set your map's coordinate system to "NAD 1983 StatePlane Vermont FIPS 4400 (Meters)" by right-clicking the map in the contents pane, selecting Properties, then Coordinate Systems. This prevents distorting Vermont's shape during editing.
Editing the Attribute Table: If you're only changing zoning values (not geometry), open the attribute table and double-click cells to modify values. Be sure to follow the data documentation for standardized values across the state.
Editing Geometries: When modifying district boundaries:
- All jurisdictions must be bound to US CENSUS TIGER Boundaries - clip geometries to fit within TIGER boundaries
- Avoid overlapping districts (except overlay districts), as overlaps make statistics inaccurate
- Use topologies to prevent unintended overlaps
Updating from new GIS files:
- If you have a new .shp file or GIS file: Ensure the new file shares a unique identifier field with your original feature class, then use the "Join Field" geoprocessing tool to merge attributes
- If updating from a scanned map (.jpg/.png): Georeference the image in ArcGIS Pro. See the Maine Zoning Atlas georeferencing video starting at timestamp 35:30
Uploading Data Back to GitHub
Once your edits are complete:
- Convert back to GeoJSON: Search "geojson" in geoprocessing and select "Features to JSON"
- Check the following options in the tool menu:
- "Output to GeoJSON"
- "Project to WGS_1984"
- "Use field aliases"
Submitting Your Changes via GitHub
- Create a fork: Go to the Vermont Zoning Atlas GitHub page and click "Fork" at the top
- Upload your file: In your forked repository, open the Data folder, click "Add file" then "Upload files", and upload your updated .geojson file
- Create a pull request: Go back to the original VERSO-UVM repository, click "Pull Requests" then "New pull request"
- Compare across forks: Click "Compare across forks", ensure the left repo is "VERSO-UVM" and the right is your fork
- Review changes: Verify you see additions (green) and minimal or no deletions (red), then click "Create pull request"
Once submitted, the repository maintainers will review your contribution and merge it if it meets the project standards. Thank you for helping improve the Vermont Zoning Atlas!