add documentation

fixes #10
fixes #11
addresses #24 but should say more

Author: ericnost

CONDUCT.md

@@ -0,0 +1 @@
+EDGI's Code of Conduct can be found [here](https://envirodatagov.org/edgis-code-of-conduct/).

CONTRIBUTING.md

@@ -0,0 +1,7 @@
+# Contributing Guidelines
+
+We love improvements to our tools! EDGI has general [guidelines for contributing](https://github.com/edgi-govdata-archiving/overview/blob/main/CONTRIBUTING.md) and a [code of conduct](https://github.com/edgi-govdata-archiving/overview/blob/main/CONDUCT.md) for all of our organizational repos.
+
+## Here are some notes specific to this project:
+
+TBD

INSTALLATION.md

@@ -0,0 +1,12 @@
+# Installation
+This document describes how to get EJScreen running locally on your own computer.
+
+There are probably many ways to do this. Here's one that works:
+
+- EJScreen is built using the ASP.NET 4.8 framework. That requires a Windows machine.
+- Pull this repo using your preferred method (e.g. Github Desktop, `git`). If you're not working on an established branch, it's advisable to create one (see EDGI's contributing guidelines [here](https://github.com/edgi-govdata-archiving/overview/blob/main/CONTRIBUTING.md)). A branch is a way to develop and test code without overwriting the "official" main version of the code. Eventually, edits on your branch can be merged or "pulled" into the main branch using a "pull request."
+- In terms of editing the code, Visual Studio Code integrates well with Github and ASP.NET 4.8. 
+- Download and open VS Code. ASP.NET 4.8 sites require an IIS server. Maybe the easiest way to work with it is to install the "[IIS Express[(https://github.com/warrenbuckley/IIS-Express-Code)" extension to VS Code, enabling you to start/stop/restart the server from within the editor. In the "Extensions" menu of VS Code (Ctrl-Shift-X), search for "IIS Express."
+- IIS Express will create a configuration json for your version of EJScreen (`iisexpress.json`, available from the `.vscode` folder).
+- To test EJScreen locally, you should edit the `port` value to something like 8000.
+- Then, select "Start Website"!

README.md

@@ -1,13 +1,20 @@
 # EJScreen
 
-This is an unofficial copy of EJScreen, hosted by the [Public Environmental Data Partners](https://screening-tools.com/). Some links and text may incorrectly suggest that this site is affiliated with the US Government. We've published an initial reconstruction - you can identify the EJScreen data and index percentiles for a given block group right now. Check back soon as we put more time and resources toward the functionality of EJScreen you might be used to. Thanks for your patience and support.
+  [![Code of Conduct](https://img.shields.io/badge/%E2%9D%A4-code%20of%20conduct-blue.svg?style=flat)](https://github.com/edgi-govdata-archiving/overview/blob/main/CONDUCT.md)
 
 EJScreen is the environmental justice screening and mapping tool that utilizes standard and nationally consistent data to highlight places that may have higher environmental burdens and vulnerable populations.
 
-First-time users may find the 5-minute [EJScreen in 5: A Quick Overview of EJScreen](https://web.archive.org/web/20241008150339/https://www.youtube.com/watch?v=HZp3AWDJt5A) video helpful as an introduction to the tool.
+This is an unofficial copy of EJScreen, hosted by the [Public Environmental Data Partners](https://screening-tools.com/). Some links and text may incorrectly suggest that this site is affiliated with the US Government. We've published an initial reconstruction - you can identify the EJScreen data and index percentiles for a given block group right now. Check back soon as we put more time and resources toward the functionality of EJScreen you might be used to. Thanks for your patience and support.
 
-Other helpful resources include:
+## Other helpful resources on EJScreen:
 
+- First-time users may find the 5-minute [EJScreen in 5: A Quick Overview of EJScreen](https://web.archive.org/web/20241008150339/https://www.youtube.com/watch?v=HZp3AWDJt5A) video helpful as an introduction to the tool.
 - [EJScreen User Guide](https://web.archive.org/web/20250121194015/https://ejscreen.epa.gov/mapper/help/ejscreen_help.pdf) for navigating the various features of the tool,
 - [EJScreen Glossary](https://web.archive.org/web/20250123161322/https://www.epa.gov/ejscreen/ejscreen-map-descriptions) for better understanding the map layers and indicators being displayed in the tool, and
 - [Frequent Questions about EJScreen](https://web.archive.org/web/20250123162243/https://www.epa.gov/ejscreen/frequent-questions-about-ejscreen)
+
+## Repo Resources
+- [Installing EJScreen locally](INSTALLATION.md)
+- [Code of Conduct](CONDUCT.md)
+- [Contributing](CONTRIBUTING.md)
+- [Issues to work on or log](https://github.com/edgi-govdata-archiving/EJScreen/issues)