(a john-mac
production)
D_D Academy team members @piablo, @John M or @7i7o can help with the particulars of this process. Maybe a demo session, one-to-one synchronous instruction or video produced with step-by-step directions?
(WARNING: This is preliminary and essentially a spit-balling copy)😀
Formulate multiple-choice with choices/short-answer prompt that assess skills learned at relevant points during the lesson
Fork** the D_D Academy GitHub repo: https://github.com/Developer-DAO/academy and create a new repo branch with a name identifying either the contributor or the specific content we aim to add.
** Go to the D_D Academy repo in github (while logged in) and click on the Fork link at the top right corner.
Clone your fork: git clone <https://github.com/YOUR_USERNAME/academy
>
Optional:
Use git clone --bare <https://github.com/YOUR_USERNAME/academy> academy
instead, which allows git worktree
commands to move easily between branches as taught to us by our Jedi master Jedi master, friend and colleague @7i7o 🙏
After cloning, cd
into academy
(if you used the optional --bare
, you need an extra step: git worktree add main
and then cd
into main
) directory.
In the command line, run yarn install
to install all needed packages, and later run yarn dev
to start a local server. Then navigate to [localhost:3000](<http://localhost:3000>)
on your browser to see the local website instance. To exit, Ctrl+C
in the command line (where the server started) will kill the local server and get you back to coding.
Add questions as an .mdx
side drawer (ask for help from the folks mentioned above. It would be our pleasure to help!😁) It’s involved, so don’t worry about asking for help.
After adding the questions content (i.e. questions followed by choices), save and restart the local server with yarn dev
, check the content that you’ve added. If all looks good, stop server Ctrl+C
.
Run yarn build
to test for errors.
If all is well, create a GitHub pull request
in your branch to pull your new work into the D_D Academy main
branch.
A reviewer will check the content, suggest through GitHub for the author to revise, then after final review, the reviewer merges the pull request into D_D main
.
NOTE: Reviewers may also be content creators. For purposes of quality control, should reviewers as content creators be permitted to review their own content?