search

openaddresses / openaddresses-ops

Issues-only repo for discussion of operational considerations for OA
6 stars 5 forks source link

Website design needs #15

Open migurski opened 8 years ago

migurski commented 8 years ago

There are a few ops issues that in some way connect with the design of the OA site: a place to post coverage data, a generated list of source attributions, an eventual long-term home for parcels, and the basic visual dissonance between https://openaddresses.io and https://results.openaddresses.io.

In the past Mapbox has donated web design/development resources to get OA’s site into shape. @ingalls believes this might be possible again, and asked that we put something together that would help scope the need. At Code for America and now at Mapzen, I’ve commissioned web style guides and found them to be enormously helpful in visually unifying a spread-out collection of web resources. This issue is an attempt to describe a style guide that we hope Mapbox might donate to build on their previous work.

These are some requirements we used when creating the Mapzen styleguide:

  1. Styleguide must make the creation of on-brand, correct-looking web sites easy for all collaborators.
  2. It needs to be usable by URL and by copy/paste, according to easy-to-follow directions.
    • URLs should point to simple, plain CSS and JS resources.
    • The preferred interaction is copy/paste from example pages and pattern snippets.
    • No direct use of pre-processor sources or raw includes.
  3. Samples should exist for a couple common page types. Right now those include a big-header front page and a small-header content page.
  4. Patterns should exist for lots of common site elements.
 
 Basic text markup such as headers, lists, paragraphs, and so on should Just Work and might not need any special mention in the styleguide.

Is anything from this description clearly missing? Is this a reasonable request?

cc/ @ingalls @tristen

heyaustinwood commented 6 years ago

@migurski I've been watching the oa project for quite some time, as we're planning on using address data in our new project this year at Neighborhoody.

Looking through the open issues, this one caught my eye. I'm not an engineer nor do I have a gis background, so I never found a place to contribute to the project with my skillset, until now. I come from the creative world, not engineering, with a background in design, web-dev, and ui/ux.

This issue is still open, and recently @ingalls removed his assignment, so... are you looking for contributors for a web style guide?

ingalls commented 6 years ago

@heyaustinwood This would be amazing if you have time!

My plan was to migrate from mapbox/base (What the current website is based on) to use: https://www.mapbox.com/assembly/

That said, I'm open to suggestions and ideas for getting to a more documented system so we can make results.openaddresses.io more stylistically similar to the main page

Happy to answer questions if you want to take this on

heyaustinwood commented 6 years ago

@ingalls great. Available for a quick call sometime this week?

ingalls commented 6 years ago

@heyaustinwood yup for sure, send me an email at ingalls@protonmail.com and we can exchange phone numbers

migurski commented 6 years ago

Excited you two are looking at this! Nice to meet you Austin, glad you’re interested in helping.