Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Create a "prototype page" #18

Open
rkdarst opened this issue Sep 21, 2020 · 0 comments
Open

Create a "prototype page" #18

rkdarst opened this issue Sep 21, 2020 · 0 comments

Comments

@rkdarst
Copy link
Member

rkdarst commented Sep 21, 2020

Carpentries lessons are very standardized, with a fixed format. CR doesn't exactly have that, but we do have conventions. Perhaps we should think about what the typical conventions are, and how it differs from Cs.

Here is a prototype page I've made so far:
https://coderefinery.github.io/sphinx-lesson/sample-episode-rst/
We should all take a look and make sure it looks as we expect a typical page to look, and adopt any conventions early.

Examples:

  • embed solution admonition block within the exercise block itself
  • conventions for exercise labeling/titles
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant