ATTENTION This is an experimental test of The Carpentries Workbench lesson infrastructure. It was automatically converted from the source lesson via the lesson transition script.
If anything seems off, please contact Zhian Kamvar [email protected]
This is a Data Carpentry lesson on OpenRefine for social scientists. Please see https://datacarpentry.org/openrefine-socialsci/ for a rendered version of this lesson.
This is an introduction to OpenRefine designed for participants with no previous experience. This lesson can be taught in ~ 2 hours, excluding setup. The episodes in this lesson cover introductory topics related to using OpenRefine.
The instructor notes contain some tips about how to best teach this workshop.
We welcome all contributions to improve the lesson! The maintainers will do their best to help you if you have any questions, concerns, or experience any difficulties along the way.
We'd like to ask you to familiarize yourself with our Contribution Guide and have a look at the more detailed guidelines on proper formatting, ways to render the lesson locally, and even how to write new episodes.
Please see the current list of issues for ideas for contributing to this lesson.
For making your contribution, we use the GitHub flow.
Look for the tag 
Please read Contributing before starting the work. This section and the next are only a very brief introduction to providing changes.
This lesson website is built from Markdown files using the Jekyll static site generator.
The episodes that make up this lesson are in the _episodes directory.
If you want to create a pull request (PR) with changes in any of the episodes or other Markdown
files, it helps if you can preview the results of your changes before you submit the PR.
This is explained in the next section.
The lesson example explains all the steps needed to create and update a lesson like this one.
This is helpful for submitting a pull request, but not required.
Please see the instructions on setting up your computer for previewing the lesson.
Previewing the lesson requires Ruby and the bundler gem;
if you have Make, the commands become shorter.
To preview any changes on your own computer, you may either:
- use GNU Make:
make serveormake site; or - use Jekyll directly:
bundle config set --local path .vendor/bundle && bundle install && bundle updatebundle exec jekyll serveorbundle exec jekyll build
The serve commands start a webserver that updates the output every time you save a file.
The site/build commands only create the HTML output in the _site directory.
See Checking and Previewing for more information on previewing your changes, as well as commands for running various checks.
The current maintainers of this lesson are:
They can usually be reached in our Slack channel and through issues in the GitHub repository.