carpentries-incubator / scientific-metadata

Introduction to the Fundamentals of Scientific Metadata
https://carpentries-incubator.github.io/scientific-metadata/
Other
6 stars 0 forks source link

[Content Review] Learner perspective #4

Closed SilkeGerlich closed 1 year ago

SilkeGerlich commented 1 year ago

This content review will be conducted through the eyes of a potential learner. It focuses on the content that is directed specifically at learners (anything only accessible in learner view mode).

General review instructions

Where to start

Minor Changes If you find a typo or grammar mistakes, feel free to directly change them in the individual documents provided below.

Major Changes If you find larger issues with the content (representation, structure, clarity), comment this preferably at the respective place in the pull request. Or use this issue for overarching comments or feature requests

While reviewing the content please also keep an eye on:

Through the eyes of an INSTRUCTOR :eyes:

Guiding questions

Keep these questions in the back of your mind, while reviewing the content

Focus points

List of documents for review

look at these documents in depth:

  1. Landing page: index.md
  2. Learner profiles: learner-profiles.Rmd
  3. Episode 1: getting-started.Rmd
  4. Episode 2: data-metadata.Rmd
  5. Episode 3: structure-schema.Rmd
  6. Episode 4: enabling-technologies-standards.Rmd
  7. Episode 5: web-locations-identifiers.Rmd

disregard these files as they are still under construction:

  1. Acknowledgements: acknowledgements.Rmd
  2. Meet the Creators: meet-the-creators.Rmd
  3. Outlook - Linked Data: conclusion-outlook.Rmd will be included in lesson version 1.1

:exclamation: Keep in mind, that the learner content is meant as supplementary information for learners in addition to the lesson participation. You might need to switch between Learner view and Instructor view to get the full idea of what is taught in the individual episodes

When you finish your review

Good to know

If you have immediate questions or need a quick fix, use the review Mattermost channel or comment in this issue.

:heart: Thank you so much for your support in the reviewing process :heart: