Closed Frijol closed 2 years ago
Here is the database, which does in fact have some documentation in the readme https://github.com/SBUtltmedia/ECHOEPA_MYSQL
Repo has been transferred to EDGI ownership: https://github.com/edgi-govdata-archiving/ECHOEPA-to-SQL
This has been sitting around for awhile. What do we need to do? @Frijol ?
oh, good question. I feel out of touch with this at this point. @ericnost @shansen5 @maalvikabhat what documentation around the database exists, and what would be useful to create?
I think this merits a whole meeting or more worth of discussion....Perhaps at this Tuesday's notebook/database meeting.
Exists: a list of tables and columns (see above) a description of the columns in each (on the EPA website) Paul is implementing a timestamp feature so we can identify the last update.
These two things, alongside a SQL primer, are the bare minimum to allow people to customize queries.
A lot of it depends on our expected audience - who would need to know about the database? If it's just internal to EDGI, perhaps it's sufficient not to duplicate EPA's own documentation. If it's some other audience, maybe we need to customize that documentation.
Anyway here I go!
I've struggled with the question of documentation and primers in part because we've always had our heads down writing and verifying the notebooks, but also because I've struggled to understand the expected audience/use. Conceptually I know they are valuable, but it's been hard to concretize that. Sometimes it's felt like busywork. That's purely a failure on my part, but again, it would be good to meet and hash this out.
I also haven't been able to put good bounds around all this:
Yeah. I'm struggling to find appropriate bounds because I don't actually know SQL, so possibly this is already more accessible than I think? But I also would expect to be able to work with existing SQL syntax to add headers & I don't know what's available or how to find out.
I would be ok with closing this issue until we have a more specific/scoped definition of what's needed
This issue has been automatically marked as stale because it has not had recent activity. It will be closed in seven days if no further activity occurs. If it should not be closed, please comment! Thank you for your contributions.
This issue has been automatically marked as stale because it has not had recent activity. It will be closed in seven days if no further activity occurs. If it should not be closed, please comment! Thank you for your contributions.
Would be useful to document:
mySQL dump may be a starting point:
┆Issue is synchronized with this Trello card