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
Browse the website that I have shared with you (Start here:site/docs/index.html) in Instructor View.
Open the document's diffs in the pull request #1 (see list provided below), that corresponds with the site you are currently reviewing.
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:
spelling / grammar
hyperlinks (all links should be active and open a new tab in your browser.)
clarity / understandability
site navigation
Through the eyes of an INSTRUCTOR :eyes:
Guiding questions
Keep these questions in the back of your mind, while reviewing the content
Take a look at the learner profiles and put yourself in the shoes of these personas...
Are the learner profiles identifiable?
Do you feel engaged by the content and representation of the lesson?
In your view, does this lesson make a professional information?
Imagine, you participated in this lesson and use this site as a handout, do you lack any more information?
disregard these files as they are still under construction:
Acknowledgements: acknowledgements.Rmd
Meet the Creators: meet-the-creators.Rmd
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
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
site/docs/index.html
) in Instructor View.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
learner profiles
and put yourself in the shoes of these personas...Focus points
List of documents for review
look at these documents in depth:
disregard these files as they are still under construction:
: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
andInstructor view
to get the full idea of what is taught in the individual episodesWhen 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: