LibraryCarpentry / lc-open-refine

Library Carpentry: OpenRefine
https://librarycarpentry.org/lc-open-refine/
Other
52 stars 134 forks source link

Re-write the first sentence of Episode 1 to be more straightforward and useful #335

Open ostephens opened 7 months ago

ostephens commented 7 months ago

How could the content be improved?

The first sentence of Episode 1 is "OpenRefine is a desktop application that uses your web browser as a graphical interface."

This sentence is quite jargon heavy and it is unclear what the learner is meant to take away from this sentence. Perhaps the emphasis should be on:

As sentence is edited should make sure that any terms are linked to definitions as appropriate (browser, what 'runs locally' means, what 'cloud based' means as appropriate)

ostephens commented 7 months ago

The Data Carpentry Social Science / Ecology OR lessons has text https://datacarpentry.org/openrefine-socialsci/01-introduction.html#before-we-get-started

Note: this is a Java program that runs on your machine (not in the cloud). It runs inside your browser, but no web connection is needed.