• Skip to primary navigation
  • Skip to main content
  • Skip to primary sidebar
  • Skip to footer

The Alexandria Archive Institute

OPENING THE PAST, INSPIRING THE FUTURE

  • About
    • History
    • Mission
    • People
    • Governance
    • Community
    • What We Do
      • Open Context
      • Technology Innovation
      • Research
      • Advocacy & Leadership
      • Education & Training
  • Impacts
    • Publications
  • News
  • Projects
    • Data Literacy Program
    • Digital Data Stories
    • Sustainability, Collaboration, & Network Building
    • Digging Digital Museum Collections
      • Resources
  • Digital Data Stories
  • NEH-NADAC
    • NADAC People
      • NADAC Faculty
      • NADAC Advisors
      • NADAC Core Team
    • NADAC Resources
      • NADAC Curriculum
    • NADAC Apply
  • Search
  • Donate Now!

Recipe for a good tutorial

September 2, 2021 by Paulina Przystupa

Data Stories Logo

Digital Data Stories

Welcome back to the Digital Literacy Program (DLP) here at the Alexandria Archive institute! Currently, we’re wrangling the evaluations of our first Data Story. If you haven’t herd about it, mosey on over here to find out more. In the meantime, we thought we’d share our recipe for a good tutorial.

While we can’t give an ingredients list, we can share some guiding principles. Besides deciding how to test the efficacy of our work, we considered how our data stories were different from existing tutorials. But we also didn’t want to start from scratch.

For this, we reflected on our own experiences and existing projects like The Programming Historian and The Open Digital Archaeology Textbook. We thought about tutorials we had used before. And if there were any we kept coming back to. After considering those, we went through a lot of options before starting our first data story.

However! We don’t have to dive into all those options, because we’ve considered the steps we took and reconstructed them into a set of questions. The first question was the biggest:

What goes into our tutorial?

While that question introduces many others, it comes down to a more manageable question of:

What do we want to teach?

Although that is also a huge question, it was something the DLP had already decided. We wanted to teach archaeological data literacy. This will be different for other projects but once that’s decided, it’s a lot easier to answer the next questions.

For us the next question was:

What assumptions will we make in this tutorial?

While it can be terrible to assume things, we have to start off with a few assumptions or else we can’t start making a tutorial. These assumptions allow us to decide which concept a tutorial should start with. After chewing the code for Cow-Culating Your Data With Spreadsheets And R, one may have noticed that we assume users have only a basic familiarity with spreadsheets and R.

A list of the key concepts from the Cow-culating your data tutorial, these incldue: 1. Download a file from the internet 2. Load data from a file on our computer into a spreadsheet 3. Explore columns in those data 4. Select one column to visualize 5. Make different sorts of text-based visualizations 6. Make a bar chart 7. Save our plots and other outputs Estimated time to complete this tutorial: 30-60 minutes

These are some of the concepts that were part of the first data story. These steps help scaffold the basic skills we need to know before manipulating data

Furthermore, considering assumptions leads well into our next question, which was:

Who do we want using the tutorial?

Who we want using a tutorial may also drive our assumptions about where to begin. For our project, we defined “who” as students of- and life-long learners in- archaeology. Once we figure this out, it’s much easier to address other questions like:

What sort of language should we use?
How long should the tutorial be?

Those questions are important when we consider the intended audience, what assumptions we make in the tutorial, and depend on what we want our audience to consume in a single sitting. Our last question and possibly the most important is:

How do we get folks to use our tutorial?

When we write tutorials for a class, we have a guaranteed audience. However, for tutorials that are public, like data stories, it’s difficult to know how to get folks to use it.

We chose to do this by collaborating with specific communities. Our primary method was by asking educators if they’d be interested in the tutorials. Then we asked how they wanted to incorporate them into their classes.

We hope that by keeping these questions in mind as we write more data stories, they will help this program to build a successful series that improves archaeological data literacy.

Share this:

  • Twitter
  • Facebook
  • LinkedIn

Category News| Projects Tags best practices| data literacy| datastories| tutorial

Previous
Out-of-the-Box Tutorials vs. Customized Lesson Plans; or, How To Avoid Reinventing the Wheel
Next
Archaeological Data Literacy @ the Teaching and Learning in Archaeology and Heritage Conference

Primary Sidebar

  • About
    • History
    • Mission
    • People
    • Governance
    • Community
    • What We Do
      • Open Context
      • Technology Innovation
      • Research
      • Advocacy & Leadership
      • Education & Training
  • Impacts
    • Publications
  • News
  • Projects
    • Data Literacy Program
    • Digital Data Stories
    • Sustainability, Collaboration, & Network Building
    • Digging Digital Museum Collections
      • Resources
  • Digital Data Stories
  • NEH-NADAC
    • NADAC People
      • NADAC Faculty
      • NADAC Advisors
      • NADAC Core Team
    • NADAC Resources
      • NADAC Curriculum
    • NADAC Apply
  • Search

Footer

Contact

contact@alexandriaarchive.org
125 El Verano Way
San Francisco, CA 94127
415-425-7380

Visit

Support AAI

Donate