palewire / django-calaccess-campaign-browser

A Django app to refine, review and republish campaign finance data drawn from the California Secretary of State’s CAL-ACCESS database
http://django-calaccess-campaign-browser.californiacivicdata.org
MIT License
17 stars 12 forks source link

Add Data Context #185

Closed bllchmbrs closed 9 years ago

bllchmbrs commented 9 years ago

One of the things that I think is so hard about working with this data is understanding what I am working with.

I feel it would really help contributions if you could understand what exactly this data represents and what kinds of questions can and can't be answered with it. The column names and tables are so arcane that any lay developer needs a ton of expertise/time to be able to get their hands dirty with working with this data.

It'd be great to have a journalist/someone with writing skill add this sort of information into the documentation. What is this data, what does it mean, what does it show?

palewire commented 9 years ago

You are 100% right, and the goal is to get there. However we're still in the process of untangling the dozens of tables and forms in the system. We have to figure it out before we can document it!

That's going to be a slow, forensic process and we need all the help we can get.

Right now we have routines that extract and transform the "filers" who put in campaign paperwork for two kinds of filings (1uarterly disclosures and late disclosures) with their summary totals, and line-item contributions disclosed on those same forms.

Each of those routines should only be considered a draft, and we need people to invest time vetting and improving them. And after that there's a whole hell of a lot more data to go get (expenditures, "independent spending," major donor forms, etc).

Once we develop the expertise necessary to bless our code as fully accurate, then we're ready to start writing docs and telling other people how to do it.

palewire commented 9 years ago

Since this is such a large overarching mission of the project rather than a specific task I'm going to close the ticket, but it is a very crucial goal you can see reflected in many of the other tickets.

bllchmbrs commented 9 years ago

Yup, makes sense. Just wanted to have a conversation about it!