docs update

legiongis · Nov 30, 2022 · 91e6aa0 · 91e6aa0
1 parent 9f194e5
commit 91e6aa0
Show file tree

Hide file tree

Showing 14 changed files with 85 additions and 15 deletions.
diff --git a/docs/_static/css/style.css b/docs/_static/css/style.css
@@ -30,3 +30,7 @@ body {
     color:#182F4C;
     font-weight:900;
 }
+
+p.caption {
+  margin: 10px 0px 0px 0px;
+}
diff --git a/docs/activities.rst b/docs/activities.rst
@@ -0,0 +1,16 @@
+===================
+Why use volunteers?
+===================
+
+Upon taking stock of the data that we had available, and the resources we could put toward analyzing it, we came up with three different activities that would each improve our karst-related data through citizen involvement. Not only did this allow us to create new datasets that could be used in further spatial analysis, but it also provided a way for Crawford county residents to engage in the process.
+
+Some `original content </about/csp/index.html>`_ related to these efforts is still available, but more detailed writeups can be found below.
+
+Activities
+==========
+
+.. toctree::
+
+    analyzing-wcrs
+    adjusting-well-locations
+    evaluating-sinks
diff --git a/docs/adjusting-well-locations.md b/docs/adjusting-well-locations.md
diff --git a/docs/adjusting-well-locations.rst b/docs/adjusting-well-locations.rst
@@ -0,0 +1,5 @@
+========================
+Adjusting Well Locations
+========================
+
+asdfiasdfnasdf
diff --git a/docs/analyzing-wcrs.md b/docs/analyzing-wcrs.md
diff --git a/docs/analyzing-wcrs.rst b/docs/analyzing-wcrs.rst
@@ -0,0 +1,14 @@
+===================================
+Analyzing Well Construction Reports
+===================================
+
+Mining Data From WI WCRs (for wells pre-1989)
+=============================================
+
+A wealth of information exists in well construction reports (WCRs), some of which is valuable when you are looking for evidence of karst geology. The Wisconsin Geology and Natural History Survey (WGNHS) stores digital archives of all WCRs for wells created  before 1989. These come in the form of PDFs, which, though generally legible and full of information, are hard to use for any large scale analysis.
+
+The Crawford Stewardship Project in Southwestern Wisconsin wanted to mine the data from WCRs to support their efforts to protect water quality in a geologically fragile region of that state.
+
+In order to pull relevant information from these reports (of which there are 1,136 in Crawford County) we set up a web-based interface through which volunteers were able to view each image and easily enter certain pieces of information gleaned from the document. We spent a lot of time  working with the Crawford Stewardship Project to discern which specific information should be gathered, knowing that there would be a fine balance to  strike between asking too much of the volunteers, and getting too little information.
+
+After our first 2 hours, we pulled data from 886 of the 1,136 (78%), leaving only 250. More folks pitched in the following day to finish everything up. You can view the full response spreadsheet here or check out the chart below for a summary of the information we gathered (percentages are out of 1,136).
diff --git a/docs/creating-karstology.md b/docs/creating-karstology.md
diff --git a/docs/creating-karstology.rst b/docs/creating-karstology.rst
@@ -0,0 +1,10 @@
+=====================
+Web App Architecture
+=====================
+
+Early web interfaces for this project utilized the now-long-lost GeoExplorer suite put together by Boundless. As we gained experience with other web technologies, specifically Django + PostGIS + Geoserver, we eventually settled on a completely homespun application. This architecture facilitated the :ref:`Evaluating Sinks` activity, and overall worked quite well. The diagram below provides a high-level look at how we set things up:
+
+diadiadiagram
+
+To summarize: We created a Django web application with a PostGIS database backend that holds all of our sink(hole) location information. Separately, we setup Geoserver to read from the database and generate WMS endpoints that we could use in the Leaflet map frontend of the application. When people viewed the web map, they were seeing tiles generated by Geoserver. When they selected a sink for editing (choosing a sink type for it), their choice was submitted to the database via Django, and the map layer was refreshed to force Geoserver to update the style based on the new data.
+
diff --git a/docs/evaluating-sinks.md b/docs/evaluating-sinks.md
diff --git a/docs/evaluating-sinks.rst b/docs/evaluating-sinks.rst
@@ -0,0 +1,5 @@
+================
+Evaluating Sinks
+================
+
+okie doke!
diff --git a/docs/generating-sinks-from-lidar.md b/docs/generating-sinks-from-lidar.md
diff --git a/docs/generating-sinks-from-lidar.rst b/docs/generating-sinks-from-lidar.rst
@@ -0,0 +1,10 @@
+===========================
+Generating Sinks from LIDAR
+===========================
+
+asdfasdfn
+aasdfasdf
+
+
+asdindfndf
+==========
diff --git a/docs/index.rst b/docs/index.rst
@@ -1,23 +1,27 @@
-Contents
 ========
+Welcome!
+========
+
+The `Karst Geology Viewer` is a creation of the `Crawford Stewardship Project <https://crawfordstewardship.org>`_ to map and explore the geology of southwestern Wisconsin. YOu can read more about the project here.
 
 .. toctree::
    :maxdepth: 1
-   :caption: Project Background
+   :caption: Welcome!
 
-   overview
+   introduction
 
 .. toctree::
    :maxdepth: 1
    :caption: Volunteer Activities
 
+   activities
    analyzing-wcrs
    adjusting-well-locations
    evaluating-sinks
 
 .. toctree::
-   :maxdepth: 1
-   :caption: Data Management
+   :maxdepth: 2
+   :caption: Behind the Scenes
 
    generating-sinks-from-lidar
    creating-karstology

diff --git a/docs/overview.md → docs/introduction.rst b/docs/overview.md → docs/introduction.rst
@@ -1,9 +1,16 @@
-# Introduction
+============
+Introduction
+============
 
-Initial pieces of this project were funded by two grants from [Save The Hills Alliance](https://wisair.wordpress.com/about-stha/), in 2016 and 2017. [Crawford Stewardship Project](https://crawfordstewardship.org) (CSP) worked with [Legion GIS](https://legiongis.com) to explore new, volunteer-driven methods for mapping karst features in Crawford County, Wisconsin. Our objective was to combine open data, geospatial analysis, and basic web tools to generate new karst-related information through citizen engagement.
 
-Out of these efforts, and with further investment from the CSP in subsequent years, we have created this website, _Karstology_ to disseminate some of the data created in the project, and to hold and display new geospatial datasets related to karst geology as they become available.
+Purpose
+=======
+
+This website seeks to pull together a variety of spatial data resources to help illustrate the karst geology of southwestern wisconsin, and provide tools for citizens to explore and participate in groundwater conservation.
 
-## Volunteer Activities
+Background
+==========
 
-Upon taking stock of the data that we had available, and the resources we could put toward analyzing it, we came up with three different activities that would each improve our karst-related data in a different way.
+Initial pieces of this project were funded by two grants from [Save The Hills Alliance](https://wisair.wordpress.com/about-stha/), in 2016 and 2017. [Crawford Stewardship Project](https://crawfordstewardship.org) (CSP) worked with [Legion GIS](https://legiongis.com) to explore new, volunteer-driven methods for mapping karst features in Crawford County, Wisconsin. Our objective was to combine open data, geospatial analysis, and basic web tools to generate new karst-related information through citizen engagement.
+
+Out of these efforts, and with further investment from the CSP in subsequent years, we have created this website, _Karstology_ to disseminate some of the data created in the project, and to hold and display new geospatial datasets related to karst geology as they become available.