CLAassistant
commented
4 years ago
All committers have signed the CLA.
Closed courtneyphillips closed 4 years ago
CLAassistant
commented
4 years ago
All committers have signed the CLA.
nr-opensource-bot
commented
4 years ago :tada: This PR is included in version 1.1.0 :tada:
The release is available on GitHub release
Your semantic-release bot :package::rocket:
Hey all! For those that don't know me, I'm Courtney, an Instructional Designer on the NRGE team. I met with Aidan last week to discuss reviewing this course from an instructional design/NRGE lens.
The majority of suggestions in this PR are wording and sentence structure tweaks to maximize clarity and readability, and align with instructional design best practices. This includes things like breaking up longer technical sentences into smaller chunks, adjusting from passive into active voice, clearly stating purpose at the beginning of each lesson, etc.
Note that I did not alter technical content in this PR. No queries were changed. The heart and meaning of technical definitions and explanations remain the same (just with the wording tweaks mentioned above). I'm not a NRQL subject matter expert, so I can't offer much technical feedback. (But I did learn a ton reviewing these lessons!)
Aidan also shared this feedback document with me. Some of these suggestions are included in this PR, especially those that fell into the instructional design realm, such as:
Adding oxford commas throughout
Replacing terms like "simply", "just", and "obvious" with terms that don't imply ease, aiming to increase accessibility and learner confidence. (e.g. Referring to something as objectively "taking only 3 steps" instead of "easy" or "simple".)
Replacing terms like "ninja" and "samurai" with more widely-used terms like "power user", "pro", "wizard", "expert", "hero", etc.
Making some of the wording/sentence structure/voice updates suggested in feedback.
Acknowledging varying skill levels in the course overview.
Let me know if you have any questions, or if there's anything else I can help with. Overall, really amazing work. Thanks for the opportunity to review it! I've got to say, after over a year at New Relic this is one of the coolest trainings I've seen. It's also caught the attention of our instructional design team! We may ask you for tips, tricks, customer feedback, and your overall experience if/when we explore creating similar in-product materials, if your time allows. :)