Skip to content

Commit

Permalink
Rewrite README to explain the purpose of this repo
Browse files Browse the repository at this point in the history
  • Loading branch information
nygrenh committed Nov 28, 2019
1 parent faad068 commit 49f451a
Showing 1 changed file with 31 additions and 3 deletions.
34 changes: 31 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,48 @@
# Ohjelmointi 19
# Material template

This repository contains both the source code of this course's webpage and the source for the content of the course. The content is located in the `data` folder and everything else is for the website.

## Contributing to the content

If you spot a mistake, feel free to open an issue in this repo after consulting with the course assistants.

If you'd help us making the correction, you can open a pull request with your proposed changes. You may find these resources helpful for doing this:

* [About pull requests](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/about-pull-requests)
* [Markdown tutorial](https://commonmark.org/help/tutorial/)
* [Markdown specification](https://spec.commonmark.org/current/)

## Development environment

Below are instructions on how to setup a development environment on your own machine. These instructions are only relevant to you if you wish to chage how the course's website works or looks like. If you don't know how to program or only wish to contribute to the content of the course, please skip this section.

Requirements: recent Node

```sh
npm ci
npm run develop
```

Gatsby crashes from time to time -- if you'd like Gatsby to restart automatically, you can run `./develop-loop.sh`.

Content is in the `data` folder.

Custom markdown components are located in `src/partials`

If you want to use local, unpublished version of moocfi-quizzes for testing, run `./use-local-quizzes.sh` before running the application.
If your configuration differs from the default, add the path to the moocfi-quizzes as the first argument to the script.
An illustration of the default configuration:

```
(parent directory)
/ \ 
(this repo) [quizzes](https://github.com/rage/quizzes)
|
packages
|
moocfi-quizzes
```

Sometimes when making certain type of changes to the queries, you may wish to restart Gatsby automatically each time the development server exits. To accomplish this you can run the script: `./develop-loop.sh`.

## Authors

Material template created by [Henrik Nygren](https://github.com/nygrenh) and [Antti Leinonen](https://github.com/Redande).
Expand Down

0 comments on commit 49f451a

Please sign in to comment.