search

tgherzog / wbg-ogdtoolkit

World Bank's Open Government Data Toolkit
2 stars 5 forks source link

Essentials: Uses of Open Data #12

Closed tgherzog closed 9 years ago

tgherzog commented 10 years ago

Tim needs to provide an introductory paragraph

lindaklinger commented 10 years ago

This section is ready for review, but not sure how to change the label to indicate that. When I click on Label in the sidebar, I get a blank page. We can discuss tomorrow.

tgherzog commented 10 years ago

This ticket is "assigned" to me since I still need to provide the intro paragraph. Let's leave it in draft until that point.

tgherzog commented 10 years ago

@lindaklinger, I added some introductory text and I'm changing the status to "Ready for review," but please look and my text and revise as you think best.

lindaklinger commented 10 years ago

This is good, but I'm unclear on a few points. I'm not sure if the intro fully addresses your first objective, i.e., to summarize why use cases and apps are important, etc. First, let's back up a bit: Will your audience know what a "use case" is? I don't -- I'm assuming it helps makes data usable, but I'm not sure how. In addition, I don't think we address how governments make data application friendly, what it means to do so, or why this is important; I do see what makes a successful Open Data initiative, but the link to making data application friendly is not quite made. Can we use an example from the list to illustrate one or more of these points? I'm also not sure what you mean when you say that "complete metadata" is a factor that makes data usable. You also mention that a virtuous cycle can lead to improvements in data quality; I'd like another sentence that states how it does that. I understand where you're going with this, but there may be a few gaps in the information provided that make it difficult for a less-technical reader to grasp the concepts.

tgherzog commented 10 years ago

Will your audience know what a "use case" is?

I think this is a familiar term (and a simple google search would answer the question), but "application" is clearer still. I changed to "application."

In addition, I don't think we address how governments make data application friendly, what it means to do so, or why this is important

"application friendly" is the same as "usable." We include links to machine readability, licensing and metadata.

I'm also not sure what you mean when you say that "complete metadata" is a factor that makes data usable.

Metadata is the documentation about a dataset. So "complete metadata" simply means complete documentation. This will be further explained in "Supply and Quality."

You also mention that a virtuous cycle can lead to improvements in data quality; I'd like another sentence that states how it does that.

I added another sentence.

lindaklinger commented 10 years ago

Okay, thanks -- those changes helped a lot. Will further clarify a couple of my comments when we talk.