Read the content standards for expectations on writing review cards.
Important points from the content standards:
- A Review Card is presented to learners to help them review a learning standard they encountered in the last lesson they completed.
- Review cards contain two elements: a text block and a code block.
- A code block is not necessary if the learning standard is not about a particular function, variable, code structure. If it is about a concept, it is enough to describe the concept itself.
- The text should fully describe the learning standard and the code block should show an example of the code covered by the learning standard.
- Review cards are presented to a learner as part of Practice Packs and Cheat Sheets.
Review Cards examples:
Review cards will be tracked with the Review Cards List Google spreadsheet.
The spreadsheet contains list of Learning Standards with their URLs in Author per lesson in separate tabs. The purpose of the review cards are to make learning standards learner-facing, meaning that they essentially are learning standards rewritten with relavant code examples to help learners review the key topics covered in each lesson.
- Create a Review Card content under Practice Content in Author.
- Give the review card a title that summarizes what the review card is about.
- Review Card slug should start with
p5js-followed by the title of the review card. - Add yourself to Credited Authors
- Add Learning Standard by searching its UUID in the search field (the series of numbers and letters followed by
https://author.codecademy.com/learning-standards/in the learning standard URL). - Edit the learning standards to be learner-friendly in the Review Text field.
- Add URL of the Review Card in the Review Cards List spreadsheet.
- Add your name in the Author of Review Card column of the spreadsheet.
- Change Status to "In Progress" when you start working on the review card, and change it to "In Review" when you are done.