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

Update README.md #259

Merged
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 12 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,8 +23,9 @@ A place for the CSESoc community to learn and share their knowledge and expertis


1. Clone this repo
2. `npm install` to install all dependencies
3. `npm run dev` to start the local server
2. `yarn install` to install all dependencies
3. `yarn build` to generate an optimised version of the application for production
4. `yarn start` to start the local server

## Vision ⚡️

Expand Down Expand Up @@ -61,6 +62,9 @@ See the [wiki](https://github.com/csesoc/learning-platform/wiki).

We're CSESoc Education! Development is currently led by:

- [Max Xue](https://github.com/M-Xue)
- [Liam Smith](https://github.com/BinaryGamer)
- [Simon Nguyen](https://github.com/Allynixtor)
- [Maxwell Phillips](https://github.com/maxphillipsdev)
- [Jeffrey Yao](https://github.com/jeffreydyao)
- [Gordon Huang](https://github.com/dqna64)
Expand All @@ -71,21 +75,21 @@ We're CSESoc Education! Development is currently led by:
The Learning Platform has a standard format for publishing course revision materials. It assumes that a course revision campaign consists of a set of exercises that can be written in markdown.


In this *course-revision* folder observe that there are folders likes *1511-22T3* with mdx files inside. There is also a corresponding *1511-22T3.mdx* file next to the folder of the same name.
In this *course-revision* folder observe that there are folders likes *1511-23T3* with mdx files inside. There is also a corresponding *1511-23T3.mdx* file next to the folder of the same name.

When you create a new course revision campaign, you **must** provide the following:

- An mdx file *course-revision/<course-offering>.mdx* which contains some info about this course revision campaign and how to get set up for the exercises (e.g. downloading some starter code). The <course-offering> should be replaced with the name of the course offering that this revision session is made for e.g. *1511-22T3* The fields you must provide in the yaml are:
- An mdx file *course-revision/<course-offering>.mdx* which contains some info about this course revision campaign and how to get set up for the exercises (e.g. downloading some starter code). The <course-offering> should be replaced with the name of the course offering that this revision session is made for e.g. *1511-23T3* The fields you must provide in the yaml are:
- title: Title of the course revision campaign (e.g. CSESoc COMP1511 Revision Practice Problems)
- desc: Brief descriptoin of this course revision campaign (e.g. Practical coding exercises to help you prepare for your COMP1511 22T3 final exam)
- desc: Brief descriptoin of this course revision campaign (e.g. Practical coding exercises to help you prepare for your COMP1511 23T3 final exam)
- course: (e.g. COMP1511) (Currently not used in the code)
- offering: (e.g. 22T3) (Currently not used in the code)
- offering: (e.g. 23T3) (Currently not used in the code)
- A folder *course-revision/<course-offering>* which contains mdx files for each exercise. The fields you must provide in the yaml are:
- title: Title of the exercise (e.g. BST Difference)
- desc: Brief description of exercise (e.g. Find the mininum distance between any two numbers in a binary search tree)
- class: Which course this exercise is for (eg. COMP2521)
- difficulty: Difficult rating (1=easy, 2=medium, 3=hard) (e.g. 2)

Note: Both the <course-offering>.mdx and <course-offering> folder **MUST** share the exact same name in order to work (e.g. file `1511-22T3.mdx` and folder `1511-22T3`)
Note: Both the <course-offering>.mdx and <course-offering> folder **MUST** share the exact same name in order to work (e.g. file `1511-23T3.mdx` and folder `1511-23T3`)

Once you have uploaded these files you can navigate to them at the url */course-revision* (e.g. *learn.csesoc.org.au/course-revision* or *localhost:3000/course-revision*)
Once you have uploaded these files you can navigate to them at the url */course-revision* (e.g. *learn.csesoc.org.au/course-revision* or *localhost:3000/course-revision*)