BlockedScoped is 100% open sourced on Github. New questions and revisions to existing questions can be done via pull request.
Contributing new questions (and answers)
Each topic of questions has its own markdown directory and readme (listing) within the
docs directory of the project. Each individual question has its own Markdown (
.md) file within the associated topic directory.
Any new question should have a new
.md file created in the topic directory and should use the following template (Markdown text can be utilized within all the named slots).
The More You Know 🌈
BlockScoped is built on VuePress which leverages Markdown for easy writing and Vue for its components and layout.
Categories and difficulties are the only exceptions to using markdown within slots. A category or difficulty should leverage their associated Vue component for being rendered (example above)
Specifying Categories and Difficulties
Category and difficulty components reference an existing list of objects (matched by
key) for how they should be rendered.
Current categories and difficulties:
New categories and difficulties can be added at
New topics should be requested via Github issue as there is a more complicated set up of steps required for adding a topic.
Adding new question metadata
Every topic has an associated
.json file that contains metadata on every question. Every new question must have its
.json file updated in order for it to be included in the question finder.
These files are located in
The format for one question should follow:
💯 Question Requirement Checklist
Questions must satisfy the following criteria to be merged:
✔️ Question described accurately within question slot
✔️ The topic must be provided within the categories slot with the Category component
✔️ One and only one difficulty is provided within the difficulty slot via Difficulty component
✔️ Answer provided within the answer slot
✔️ Linkable references are provided within the reference slot
.json file updated in