Skip to content

Better chunking/less text needed for content in "Conducting a rapid usability test" #14

@jlcohoon

Description

@jlcohoon

In the "Conducting a rapid usability test" episode, the "Ensuring smooth data collection" section is a lot of text. Reducing this text and/or breaking it up would help it be more parsable. Below are some thoughts on how to achieve this, but other contributors might have different ideas. Keep in mind that a preferred teaching strategy is to use exercises to teach content, not just practice what was already written elsewhere.

Possible approaches:

  • trim text
  • make another section in the episode and move some content there
  • move some content into callouts or collapsable divs

Before addressing this issue, please leave a comment describing your approach so that others can assist without duplicating work. Tag a reviewer (e.g. @jlcohoon) as well.
Please check that the "Overview" and "Key Points" don't need adjusting after your edits

Carpentries info on formatting the different kinds of callouts and collapsable content like exercises might be useful: https://carpentries.github.io/sandpaper-docs/instructor/component-guide.html
https://carpentries.github.io/lesson-development-training/lesson-content.html#adding-exercises

Metadata

Metadata

Assignees

No one assigned

    Labels

    good first issueGood for newcomersmedium effortsome UX or Carpentries expertise needed and/or may be somewhat time consuming taskssome direction provideda little guidance on how to address the issue is provided

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions