Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

include information about the data, links to additional data sets and API within the campaign finance data section #833

Closed
Tracked by #104
onezerojeremy opened this issue Feb 24, 2017 · 11 comments
Assignees
Milestone

Comments

@onezerojeremy
Copy link

The sitemap/IA has us adding a few new data sources and information about them to the campaign finance data section.
screen shot 2017-02-24 at 5 06 49 pm

We also are looking for a way to re-incorporate the API back into the site architecture.

Here's a first take at those.

  1. About the data and API links.
    So the about the data page has good explanatory content about where to find certain aspects of the data, and importantly, the terms-of-use-esque language forbidding the use of this data for commercial ends. I think both of these bits of data feel like they belong as part of the data footer, as it provides a way to surface the warning anywhere someone might wonder about how it can be used, which is to say, while browsing the data sections in places where the underlying data is exposed (on the candidate and committee pages, on the data tables, on the advanced data landing page). Here are two looks at that:
    1.1: data footer where about the data and api are added to footer menu, terms of use are directly exposed
    data footer

1.2: data footer where about the data and api are added to footer menu, terms of use are included via a sentence which links directly to the sale and use section of the about the data page.
data footer less terms

  1. Bulk data and other sources. (and also the API again)
    To me, this feels like another section of Advanced data. Still not sure how we want to call out the difference in the links to the legacy content, but leaving that alone for now, each of the links to the data download and other sources are included as links in a new section very tentatively titled "Bulk data downloads and other sources". This is also felt like another place to call out the API, which can be viewed as another data source.
    advanced-data-v3 b

2.2 Here's basically the same layout, but instead of adding the API to the other sources, it shows up as a "more ways to explore the data" card.
advanced-data-v3 a-more api love

for more on the nav, see 827

Obviously all this is very drafty, but should give us something to talk about on Monday! :)

@onezerojeremy
Copy link
Author

actually i'm already seeing that i missed some of the data sets! I'll see if they break the pattern on Monday.

@onezerojeremy
Copy link
Author

Updates on this, from this morning's pairing with @jenniferthibault, @emileighoutlaw and @nickykrause :

  1. I was mistaken about the amount of room in the footer, and as such the "don't use this data for bad things" warning won't work there. (though the API link works fine there). @jenniferthibault pulled another 🐇 out of her 🎩 , with the data disclaimer used in other sections of the site, so that's what you're seeing here.

  2. added in the missing links, including:

  • PACronyms : included as an aside in the Committee section
  • "candidates financial disclosure forms": I'm interpreting this as "forms index", and also including it as an aside, this time within the candidate section.
  • First pass at the rest of the links to particular data sets, now re-organized to mimic the categorization in the sitemap.
  • of these, probably the one I'm least confident about is the "data catalog", which I've very tentatively named "legacy data catalog", which links to a page with links to lots of different data sets. It might be fine as is, but it's a lot of different stuff that doesn't fit easily in any particular category that I can think of.

will upload an image when s3 comes back on line!

@jenniferthibault
Copy link
Contributor

Turns our there were more 🐇 s left in the 🎩 and @noahmanger helped me find them in a great quick review!

Check them out in this 🖌 InVision and click around, just about everything is linked to where the sitemap says it should go.

Summary of changes

  • The advanced data page was getting really long
    • I swapped out the full-page side nav for the pattern that replaces the content section instead of jumping you to it. Each section is now its own tab
  • The descriptions of each category were feeling far removed from the fields they described.
    • Using the feed pattern for each data category instead of a plain list keeps the description grouped with its category better, and will help us take a first stab at this long-open issue for Providing context for what is included in the data tables #1322. This approach will need us to evolve that feed pattern to style child/sub elements, which really help surface the relationship between data categories.
  • Made a horizontal format for the related resources patter which were typically in the right-hand column in a vertical format
  • Moved links to the API and About this data permanent, consistent cards in the "More ways to explore the data" slab at the bottom. These have basically become the sibling pages in the data section

Just about everything here will need @emileighoutlaw for content and someone for data subject matter expertise, especially:

  • the "don't sell this data" disclaimer
  • the context about each data category (I've grabbed what I could find that exists straight from the FEC site for now in some places)

Next steps

  • 18F team, I'd like to talk about this at today's design pairing session.
  • @AmyKort and @PaulClark2 this is one of the issues we'll be asking for your feedback on at Friday's chat. If you want a sneak peak, (or time to gather your thoughts), check out the InVision link at the top of this comment ☝️

@jenniferthibault
Copy link
Contributor

Had a really productive review session with @PaulClark2 on Friday that led to a few more changes to the Advanced Data section. The 🖌 InVision prototype has been updated with those changes.

Changes:

  • Re-ordered page sections to place raising and spending first to better reflect the interests of advanced data users
  • Removed inactive “coming soon” data links: better to keep adding to the site than to create the perception that information is missing or unfinished.
  • Moved candidate financial disclosure forms to External Sources, link to Office of Government Ethics
  • Provided links to the legacy data maps from the "Other FEC data" category as a holdover to when the work to replace them happens in Sprint 8 & 9

Remaining to-do's

  • @PaulClark2 is going to look into whether we can remove post-election summaries from the Bulk data page
  • @AmyKort we'd like to make sure this feels good to you as well, so please help us know what the best way to do that is. Would you like to review the prototype on your own, have us give you a walkthrough, or??? Interpretive dance perhaps? Let us know 💃

@nickykrause / @onezerojeremy this should be in good shape for testing this week!

@AmyKort
Copy link

AmyKort commented Mar 6, 2017

@jenniferthibault I'm usually never one to say no to an interpretive dance, but I looked through the prototype on my own. Looks great! I really like what we've got going here. It's very easy to find what's there and understand what you're looking at. We have a lot of data and I think it's often very hard to get oriented, or even know what questions to ask about the information you want to search. This is a great solution for that. I am also a huge fan of the terms of use at the bottom of each page, given what comes above it.

It looks like there are going to be a lot of little language issues to iron out. Will you let me know when it's time to focus on that?

@jenniferthibault
Copy link
Contributor

Oh that's great, @AmyKort! You are fast ⚡️ and I'll save the interpretive movement for our next workshop. You're absolutely right there's a lot of small copy areas we're going to need your help + @emileighoutlaw 's for nailing down.

Emileigh, how would you like to break that work down?

@PaulClark2
Copy link
Contributor

We do not need to find a home for http://www.fec.gov/finance/disclosure/PostCycleSummaryDataFiles.shtml on the new website.

@jenniferthibault
Copy link
Contributor

Thanks! Mockups updated.

@PaulClark2
Copy link
Contributor

@jenniferthibault we can also remove the links to House independent expenditure map and to Senate independent expenditure map

@jenniferthibault
Copy link
Contributor

Great! That helps cut down on some clutter under that item too. Updated!

@noahmanger
Copy link

noahmanger commented Mar 8, 2017

Tracking the implementation of this over in fecgov/openFEC-web-app#1877

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

5 participants