Overview
Questions
- What system of content generation seems easier to use for you?
- How easy will it be to explain this to a newcomer?
- What questions do you have for us?
Instructions
You will test out three methods of creating challenge/solution blocks and fill out a short survey related to their ease use. (estimated time: 15 minutes)
This website contains reference pages for each of the syntaxes as well as two pages containing challenges for you.
- Please go to https://forms.gle/dFD9Xs2cNw8qnKts5 and follow the instructions
- Briefly examine the three candidate syntaxes and rank them in the survey
- Download this answer document and save it to your desktop.
- Open the answer document in your favorite text editor and test out the three syntaxes for both Simple Nested Challenge and Complex Nested Challenge
- Copy and paste your answers in the survey (be sure to include the headers)
- Answer the post-challenge questions in the survey
Background
The nested challenge and solution blocks have been an integral part of The Carpentries for quite a while and the provide a low-stakes way for learners to test their knowledge.
Test your knowledge!
How are challenge and solution blocks created with the current Jekyll-based lesson template?
Solution
The challenge and solution blocks were created using nested block quotes with class attributes:
The goal of this lesson is to present three potential ways of creating content blocks for rendering specialized sections in the new Carpentries lesson template. Your feedback will help us understand how comfortable our maintainers will be with each of these formats so that we can choose one that we will use as our recommendation for creating these blocks.
