code4hr / adopt-a-drain

A web application that allows citizens to "adopt" a storm drain in Norfolk, Virginia

code4hr.org

The website for the Code for Hampton Roads Brigade

Goals

1. Explain what Code for HR is and the type of work we do.
2. To celebrate our events, projects, and discussions!
3. Encourage current and new members to participate with clear ways to get involved.
4. To have this site be easily reused by other Brigades just starting out.

Tech

Built using Jekyll, Bootstrap, and the CfAPI.

Contributing

Submitting an Issue

We use GitHub Issues to track bugs and features. We've included several of our open GitHub Issues right on our homepage using the Civic Tech Issue Finder.

Running the Site Locally on Your Computer

To run the site locally on your own computer (most helpful for previewing your own changes), you will need Jekyll installed (click here for Jekyll installation instructions.)

Fork and clone the repository, then run the following command in the root directory of the repo:

jekyll serve

or

jekyll serve --watch which will watch for changes to files.

Your computer should now be serving your local copy of the site at:

http://localhost:4000.

Sharing Your Changes Using Jekit

You can use the nifty Jekit app to preview changes you make to this site.

To do this, fork this repo, and commit your changes on a branch to your fork. You can then preview what your changes look like by navigating to:

https://jekit.codeforamerica.org/USERNAME/code4hr/BRANCHNAME/

For a basic example of its usage, if GitHub user @lolname has made changes to the projects page on their fork (on the master branch), they can preview their changes using Jekit by going to:

https://jekit.codeforamerica.org/lolname/code4hr/master/projects

Submitting a Pull Request

1. Fork the project.
2. Create a topic branch.
3. Implement your feature or bug fix.
4. Commit and push your changes.
5. Submit a pull request.

adopt-a-drain's Issues

Merge new drains into development & production branches

Norfolk.csv now contains all drains in the city. Add these to the dev & prod branches.

Replace San Francisco with Norfolk

Brand this version for City of Norfolk Office of Resilience

MVP: Find and replace all

Ideal: Make it configurable using locales

Update README for deployment

It's all wrong 😄

Set codeship configuration to use master branch

Needs backup and restore process

As the App Maintainer I need a process for backing up and restoring data.

Private field discrepanices

When you register, it says your last name will private. Your last name is shown when you adopt a drain (even to people who are not logged in). When you login and check your profile, it says your last name is not private. There are some other privacy options advertised in registration that don't match the reality of the app.

Registration

Adopted Drain View

Profile Options

Update README w/ git flow instructions.

Stop showing splash if signed in

As a Drain Adopter, I don't want to see the getting started splash screen every time because I am already logged in.

Don't show the splash if I am logged in.

Update contact email address

Kyle Spencer [5:27 PM]
Please use [email protected] and the video phone number is the best one to use.

Add base map choices

As a User of a web map I expect to be able to switch between base maps. At minimum I would like to switch between a street map and a satellite (with street) map.

Add updated legal documents to the app.

• Safety Guidelines
• Volunteer Release and Waiver of Liability agreement.

Add drain data for the rest of the city

City of Norfolk has provided a new data set to include all storm drains in the city. Merge old and new data set, preserving existing adoptions in production database.

Require acceptance of Terms of Service

As a User I am not required to accept any terms of service. City of Norfolk would like Users to be required to view and accept the terms.

City of Virginia Beach has implemented this in their repo:
CityOfVirginiaBeach@52c3dd7

Replace video link with City of Norfolk official

Replace the video link to my personal account with the video link to City of Norfolk's account:

https://www.youtube.com/watch?v=DzhJWccNbaQ

Update view when drain is adopted

As a User, when I adopt a drain the screen is not updated and I don't know that something has happened.

If I refresh the page I can see the change.

Update the popup and the list.

Same issue as CityOfVirginiaBeach#8

Add a "How this works" splash

As the App Owner (Resiliency Office), I want to be sure every new Volunteer is presented with a message, including how to start, how to participate, and what to expect from the Resiliency Office

Add Fairmont Park drains.

CSV file is found in code4hr slack group in the #adopta channel.

Set "Give this drain a name" text as background placeholder

As a user, when I adopt-a-drain I expect the text "Storm Water Inlet Drain" to be background form text rather than foreground text that I have to erase.

We should make this a background field text

Update featured image/thumbnail

Add a Check In Button

As any User, I want a Check In button
So that I can report when I check on the drain
Because we'd all like to keep track

Replace sfwater with [email protected]

Replace email address with [email protected]
Replace website url with https://norfolkdrains.herokuapp.com/

Fix Map for -develop

norfolkdrains-develop.herokuapp.com does not work because the map does not show.