tgherzog / wbg-ogdtoolkit

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

Round 2 Feedback #24

Closed tgherzog closed 7 years ago

tgherzog commented 9 years ago

Opening this ticket to manage edits related to external feedback in Round 2. Feedback will come in one of three ways:

  1. Via email, which I'll paste into this Google doc
  2. Edits to the raw text we provided in a Google doc
  3. Via Github (don't expect too many of these)
tgherzog commented 9 years ago

Here's the summary of round 2 feedback:

Near Term

  1. Style review: Linda is putting finishing touches on the style guide, and in the process has noticed several stylistic inconsistencies in the Toolkit (hyphenation, punctuation, etc) as well as other relatively minor editorial changes.
  2. Other minor changes: suggested by Amparo, Ton Zijilstra, and Pierre. These look very straight-forward.
  3. Open Data Definition: both Ton and Pierre suggested adding a 3rd criteria – Legally Open, Technically Open, and Free of Charge (i.e., economically open). I’ve heard this approach several times as well. I think it makes sense, but it would be a departure from what we’ve used in the past.
  4. Review list of Country level Open Data examples, as several are not terribly good examples (despite claims that they are open). This was pointed out by Rayna. Here is the list of “new” countries added in this round. Honestly, I’ve forgotten the process by which these were added:
    • Brazil (Portuguese only)
    • Costa Rica (Spanish only)
    • Ghana (assume yes? The NDSAP statement is not linked from the website; I can’t find it via Google either)
    • India (still not entirely clear to me what their license policy is)
    • Morocco (French only)
    • Oman
    • Philippines (looks good)
    • Russian Federation (Russian Only)
    • Saudi Arabia
  5. Fix identified gaps in the TA and Demand sections. We’ve given Craig et al several changes to review these, so at this point I suggest simply going ahead and doing our best.
  6. Sid had some suggestions to provide more clarity in the licensing section. From Sid:

Licenses are complicated for most average persons and giving so many choices without any recommendation or guidance will be confusing. May be we should extract some text from the “Licensing Open Data: A Practical Guide”

Long Term

These are now separate tickets: #26, #27 and #28.

tgherzog commented 9 years ago

@lindaklinger - on 2nd bullet above, I've addressed Pierre's comments on OD Benefits and later sections, and fixed the TA section. I also removed links to github issues that were just for the benefit of the reviewers.

tgherzog commented 9 years ago

Added text to the licenses section, as per Sid's suggestion.

tgherzog commented 7 years ago

closing