codeforamerica / codeforamerica.org-archive

The (former) @codeforamerica website

Code For America Dot Org

This repository holds the source code and static assets for the last version of codeforamerica.org, which can be found at archive.codeforamerica.org. Learn more about what Code for America does on our About page.

Note: Code for America's site is no longer built using the files in this repository. We've moved to another system (more details on that soon). If you want to report a bug or issue with the current site, please send an email to [email protected] or visit the site and use the live chat support feature in the bottom right of the page.

How It Works

We use Github like a content management system -- all our templates and content are collaboratively edited by staff and external contributors on Github. We use Jekyll to generate everything into static HTML files that are served using Apache.

How We Built it

Our technology and communications teams built the site in partnership with Brighton web design firm Clearleft and Colorado branding firm Dojo4. Ongoing maintenance and improvements on the site are done collaboratively with internal staff and external volunteers. Members of the CfA community are welcomed to provide their input using Github issues, or help make improvements by submitting a Pull Request.

Who’s Working On It

• David Leonard: code, design, project management
• Michal Migurski: hosting, answering many questions
• Andrew Hyder: brigade site updates
• Molly McLeod: design
• Zoe Blumenfeld: audience engagement
• Matthew Loveless: analytics
• Alexis Charles: writing
• Nicole Neditch: writing

... and many more CfA staff members and community contributors.

How to contribute

Submitting a Pull Request

An easy way to submit a pull request for just simple text changes is to:

1. Find the page you'd like to edit on the master branch.
2. Use GitHub's built in editor to make your changes.
3. Down below the editor window, include a brief one sentence description of what you changed. Something like "Updated Andrew Hyder's bio".
4. Click the green Propose File Change button.
5. You'll get to review your changes. If everything looks right, click the green "Send pull request" button.

If you need to add or replace an image, you'll need to:

1. Fork the project.
2. Create a topic branch.
3. Add the image in the correct directory.
4. Commit and push your changes.
5. Submit a pull request.

Submitting an Issue

We use the GitHub issue tracker to track bugs and features. Before submitting a bug report or feature request, check to make sure it hasn't already been submitted. You can indicate support for an existing issue by voting it up. When submitting a bug report, please include a screenshot and any additioanl details that can help us debug, such as your operating system and browser version.

Previewing 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/codeforamerica.org/BRANCHNAME/

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

https://jekit.codeforamerica.org/lolname/codeforamerica.org/master/people/dave-guarino/

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://0.0.0.0:4000.

Editing stylesheets

All CSS and stylesheets are hosted in the pattern-library repository, and served lived from http://style.codeforamerica.org.

Technology Patterns

Uses Jekyll for templating – converted HTML files are in the _site folder.

Copyright

Copyright (c) 2009-2014 Code for America. See LICENSE for details.

codeforamerica.org-archive's Issues

Update Information on Mentorship Page

Connect with Atran to update page:
http://www.codeforamerica.org/mentor/

APPS NAV: Remove Categories

Can you kill the two app nav categories with no apps in them? http://www.codeforamerica.org/apps/
POLICY PROJECTS
OTHER

link to RecordTrac app is incorrect

on this page http://www.codeforamerica.org/cities/oakland/

RecordTrac link should go to "records.oaklandnet.com" instead of "records.oaklandnet.com/new"

Change App logo image size requirement

The CSS seems to want 100px wide images right now; many of the existing ones we have are 165px wide or 150px wide. Can the logo sizes be determined by the HTML tag rather than CSS so we can re-use existing images?

Current appearance: http://dbox.teczno.com/CfA-Website-Bugs/apps-weird.png

Add `social-website` to scss/patterns/profile.scss

…should use icon-earth or something like it, for use with links to people's sites not covered by Twitter, Github, or Linkedin.

class="page-title" is lost in image

Right now the text for class="page-title" get lost in the image. Either make the text pop or get rid of it all together and just use class="global header" to identify where you are on the site.

Lots of fellows links incorrect

Not all github links are github links (some are the twitter link).

Lots of linkedin links are broken.

Might want to verify the twitter handles are correct (mine got changed incorrectly a couple months ago, and had to change it).

Video Pages

Make it so that http://codeforamerica.org/video aggregates live pages -- need a video template ? http://codeforamerica.org/08-22-2013/

De-Dupe Fellowship Pages

Duplicated lists of 2014 fellows on these three pages:

1. geeks/our-geeks/2014-fellows
2. geeks/fellows-2014
3. geeks/fellows

Number 1 should definitely stay; number 2 should definitely go. Should number 3 just have a link to the current people?

Home Page sub-navigation

BLOG: Can we switch sub-category navs to:
News: http://www.codeforamerica.org/category/news/
Fellowship: http://www.codeforamerica.org/category/fellowship/
Civic Startups: http://www.codeforamerica.org/category/civic-startups/
Civic Hacking: http://www.codeforamerica.org/category/civic-hacking-2
Cities: http://www.codeforamerica.org/category/peer-network/

PROGRAMS: Can we switch "Accelerator" for:
Civic Startups: http://www.codeforamerica.org/startups/

CTA on /apps is broken link

the "let us know" link at the end of the top paragraph of the apps page goes no where - looks like it's intended to go to a form of some kind?

Remove “Current Donors” on About page

Ashley says it’s out of date.

Replace with something so it’s not blank. If a list of donors, use names only and pull from front page carousel.

Marcin's profile video does not play

On http://www.codeforamerica.org/cities/louisville/, Shaunak's and Laura's video profiles made by Metro TV play just fine but Marcin's video gives the error message: Invalid parameters.

I will try to find a good link for the video and update the issue with it.

Sheila Dugan is mispelled

on this page http://www.codeforamerica.org/cities/oakland/

in this text "It’s for this reason that 2013 fellowship team Richa Agarwal, Cris Cristina and Sheila Duggan met with stakeholders from various Oakland departments to improve citywide public records requests."

change "Duggan" to "Dugan"

Summit County Page - List of Fixes Needed

Brigade Section

• We have three links to the same destination. Should probably reduce that.

Last graf of the "2013 Fellowship in Summit County" Section

• All URLs should be updated to tothetrails.com
• Ohio & Erie Canalway Coalition (rather than ...Canal Coalition)

Articles & Videos Section

• The use of the present tense is weird.
• There is a dead and perhaps extraneous shortened URL at the end of the last graf "kng.ht/VeQgic"

Stats are using wrong typeface

As seen on About page.

Upon City Announcement. Update Alumni Page

Alumni Fellowship Cities

Kansas City, KC	Kansas City, MO	Las Vegas	Louisville
New York City	Oakland	San Francisco	San Mateo
South Bend	Summit County	Austin	Chicago
Detroit	Honolulu	Macon	New Orleans
Philadelphia	Santa Cruz	Seattle	Boston

Shaunak's twitter ID is @shaunak

On http://www.codeforamerica.org/fellows/2013-fellows/#Shaunak, the Twitter ID is @shaunakkashyap. It should be @shaunak instead.

Sass outputs 2 hex codes in CSS when colour has no opacity.

Video Embed does not show up in Chrome

Not sure if I'm doing something wrong on this but YouTube and Vimeo embeds do not appear in Chrome.

Caption does not match photo

On http://www.codeforamerica.org/cities/louisville/, the photo of Shaunak, Laura and Marcin with the two prison officials is accompanied by this caption:

(L-R) Fellows Shaunak Kashyap, Marcin Wichary and Laura Meixell visit the prison guided by two prison guards..

The order of the fellows in the caption does not match the order of the fellows in the photo. Also, while we are changing it, these were Corrections officials, not prison guards. The caption should read:

(L-R) Fellows Shaunak Kashyap, Laura Meixell and Marcin Wichary visit the prison guided by two Corrections officials.

Increase height of fade

I’ve cherry-picked the most recent stuff from master (5544223), and I’m seeing a squat fade box at the top of the geeks page:

https://jekit.codeforamerica.org/codeforamerica/codeforamerica.org/static-site/geeks/

I tried to double the height property in patterns/fade.scss and recreated main.css, but the height of the fade box stayed at 30px.

What am I doing wrong?

"consumer" should be "community" in Summit Day One Highlights

http://www.codeforamerica.org/2013/10/21/cfa_summit_dayone/

This sentence:
"The platform of the new Ohana API supports consumer services in San Mateo County, Calif."

should read:
"The platform of the new Ohana API supports community services in San Mateo County, Calif."

Aug 12 10am PST: HOMEPAGE CHANGE: Swap in Accelerator Heroes Image

Believe I sent in pull request, but wanted to double up here. Actual change should happen on Mon Aug 12.

HEADER TEXT: Meet the Accelerator Startups
LEFTHAND TEXT: Our five accelerator companies have landed in CfA's San Francisco headquarters. Learn more about the companies or learn more about the program.
FLOAT RIGHT:

codeforamerica/cfawp2012@4ce7821

CITIES APPLY NOW PAGE: /cities/apply-now

Will require an interest form embed.

Citizens Page: What's Happening Links

On the citizens page under "What's Happening", the featured events and items like "Nov 19: Bike Hack NYU Rudin" need to be links but they are currently just text. When you create a link at that level, the CSS forces a new style. Can we keep the existing featured event style but leave room for those to be links?

Get rid of Get Satisfaction

At least one of our current City templates (examples: http://codeforamerica.org/2013-partners/las-vegas/ & http://www.codeforamerica.org/2012-partners/chicago/ ) has a janky GetSatisfaction widget at the bottom with ancient - and no recent - comments. Totally not needed any more. KILL EET.

Fix the CTA on /2013-partners

The list page of 2013 cities has a call to " if your city is interested in joining the 2014 program, apply here" - we should probably change these calls to action to something like "if you're interested in bringing the fellowship to your city, find out more" and then the /apply-now page should explain more thoroughly the current status of the application cycle.

Move search from footer to header

...where god intended search to be.

Fix spacing weirdness with headers/section on one page

I’m seeing some spacing oddness on this page: https://jekit.codeforamerica.org/codeforamerica/codeforamerica.org/static-site/geeks/our-geeks/

Trying to understand what’s going on there, with the header scrunched up against the preceding sections. What’s the correct way to implement this pattern?

Current fellows should be *current* fellows

http://www.codeforamerica.org/fellows/current-fellows/ should point to the current (2013) fellows.

There are 7 mentions of this issue on the e-mail thread supporting this change.

To facilitate the 2014 fellows, you could add a "2014 Fellows" link to the "Fellows" sub-menu.

Please add PBS video and LA Times article to SMC's Articles and Videos section

http://www.codeforamerica.org/cities/sanmateocounty/

The PBS feature was a big deal, so I think it would be great to have it included, as well as the LA Times piece.

http://www.youtube.com/watch?v=uLXWSQ_WFc4

http://www.latimes.com/local/columnone/la-me-c1-code-for-america-20130826-dto,0,400145.htmlstory

Add sponsors to Donors page in a second column

Work with Ashley to populate the second column with sponsors from secret list. Use sponsor logos to be provided by Ashley & Matt.

Cities Page: Side Scroll Weird Side Scrolly Page

Page side scrolls weirdly and the footer is only half the page. Can we remove? Additional div tag or something?

Broken link on Fellowship page

At this page http://www.codeforamerica.org/about/fellowship/

the "The End of 2013 Fellowship" link appears to have a slight problem with it (extra - character at the end, I think.)

Change Email Alias on Cities Page

• Ask Santus to create new email alias -- [email protected] that goes to Luke, Jack, Dana, LD.
• Add it to the Muni Innovation email alias
• Test it on the page (Must be done during working session as Wufoo breaks form when changes are made after it's already been embedded)

Main Nav/IA

Going with the current proposed home page concept, we still need to sort out a main nav scheme for subordinate pages. One thought I have is that we keep the Programs nav but move it under "About" and simplify the rest of the navset to go with our cities, citizens, and donors CTAs. Like this:

About | Cities | Citizens | Supporters | Apps | Blog and then events/video/search as a little bloc in a corner?

About would then be:

Mission (landing page) | Team | Programs | Press | Jobs | Contact or something like that

Maybe About would be footer only though. Interesting question. This scheme privileges donors by pulling them out of About, and pushing Programs down.

This needs more thought but just getting it started.

ANALYTICS: Configure Google Analytics to email us when site is having problems

Abhi gets a mail from chartbeat when something goes wrong; configure GA to do this instead so we can ditch CB.

2013 cities listed as 2014 cities

http://www.codeforamerica.org/cities/current/ says "2014 fellowship year" in the text but shows 2013 cities.

Add Tumblr + Flickr to social footer

Please.

CONTENT: Take Inventory of Geek Experience

Take inventory of the geek experience. Collect up:

CODE WE HAVE: Apps, API, Repo

EVENTS: From the Fellowship, Brigade, Startups, Mentoring

OUR GEEKS: Captains, Fellows, Founders, Mentors

Resolve text size differences in bio snippets & people pages

From Cyd: I'm not famous for my great eye, but to me the text styling for people cards in the pattern library looks different from how it comes out on the actual built version. Smaller type size and correspondingly smaller line spacing - the pattern library version looks much better to me (in particular the centering works better); do you see the same thing & can you tell what's going on?

Fix the Programs CTAs

Fix the CTAs on the programs http://www.codeforamerica.org/programs/

¿Design SVG versions of the social icons?

Is it possible to get social service icons in a vector format? Non-critical.

Pasting text from the site adds crap

There's some odd little bit of code - no idea where such a thing would live - that causes text copied & pasted from our site to append a cluttering "see more at URL" string. It's not a huge use case, but it's super stupid. If we can find it and kill it, awesome. Like so - I will now paste some text from the site using ctrl-C ctrl-V:

if your city is interested in joining the 2014 program, apply here. - See more at: http://www.codeforamerica.org/2013-partners/#sthash.E0k1KUZe.dpuf

Fix Footer on Finalist Detail Template

Footer on https://github.com/codeforamerica/cfawp2012/blob/master/finalist-detail-template.php is only partially gray. Weird div tag issue?

Google calendar widget - improve look & feel

In the interim, the google calendar widget is being used to display public events. It would be nice to dress this a bit to match the styleguide pattern for calendars.

Later, build something better for events.

Remove list-item dots on certain elements in phone view

I’m not sure if these are intentional, guessing not:

• http://dbox.teczno.com/CfA-Website-Bugs/dots-1.png
• http://dbox.teczno.com/CfA-Website-Bugs/dots-2.png

Blog & site bios

Looks like many blog authors don't have bios in WP, even if they have bios elsewhere on the site. (Many current fellows & staff fall in this category.) This means their author page comes up without a bio at the top. A different and I think larger set of people doesn't have the right credentials (gravatar?) to have the summary bio show up on individual posts. This could be a good one to tackle in conjunction with alumni bios, since a lot of alumni are affected.

city of oakland logo is incorrect

on this page http://www.codeforamerica.org/cities/oakland/

tree should not be the broccoli version. Should be this: