Update introduction files

CONTRIBUTING.md

@@ -0,0 +1,116 @@
+# Contributing to Open Education Hub Methodology
+
+These are recommendations when contributing to the contents of the Open Education Hub methodology.
+They consider contributions to both actual content (mostly Markdown) and support code made via Git.
+
+## First Steps
+
+Some good first steps and best practices when using Git are explained here:
+
+* the Git Immersion tutorial: <https://gitimmersion.com/>
+* the Atlassian tutorial: <https://www.atlassian.com/git/tutorials/learn-git-with-bitbucket-cloud>
+* this blog post on the `ROSEdu Techblog`: <https://techblog.rosedu.org/git-good-practices.html>
+
+## Language
+
+All of our content is developed in English.
+This means we use English for content, support code, commit messages, pull requests, issues, comments, everything.
+
+## Content Writing Style
+
+This section addresses the development of session content and other Markdown files.
+
+Write each sentence on a new line.
+This way, changing one sentence only affects one line in the source code.
+
+Use the **first person plural** when writing documentation and tutorials.
+Use phrases like "we run the command / app", "we look at the source code", "we find the flag".
+
+Use the second person for challenges and other individual activities.
+Use phrases like "find the flag", "run this command", "download the tool".
+
+## Images
+
+Use [draw.io](https://app.diagrams.net/) to create diagrams.
+If using external images / diagram, make sure they use a CC BY-SA license and give credits (mention author and / or add link to the image source).
+
+## Slides
+
+Slides are to be written in Markdown, using [`reveal-md`](https://github.com/webpro/reveal-md), itself based on [`reveal-js`](https://revealjs.com/).
+Use `reveal-md` and `reveal-js` specifics to split information in slides.
+Aim to make slides attractive, sleek and simple to follow.
+
+Images and diagrams would ideally be animated on slides.
+Aim to use `reveal.js` features to animate drawing of diagrams.
+
+If `reveal.js` drawing is difficult, use [draw.io](https://app.diagrams.net/) to create diagrams.
+Ideally you would "animate" those diagrams by creating multiple incremental versions of the diagram and adding each to a slide;
+when browsing slides pieces of these diagrams will "appear" and complete the final image, rendering an animation-like effect.
+
+## Issues
+
+When opening an issue, please clearly state the problem.
+Make sure it's reproducible.
+Add images if required.
+Also, if relevant, detail the environment you used (OS, software versions).
+Ideally, if the issue is something you could fix, open a pull request with the fix.
+
+## Discussions
+
+Use GitHub discussions for bringing up ideas on content, new chapters, new sections.
+Provide support to others asking questions and take part in suggestions brought by others.
+Please be civil when taking part in discussions.
+
+## Pull Requests
+
+For pull requests, please follow the [GitHub flow](https://docs.github.com/en/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork): create a fork of the repository, create your own branch, do commits, push changes to your branch, do a pull request (PR).
+The destination branch of pull requests is the default `master` branch.
+
+Make sure each commit corresponds to **one** code / content change only.
+If there are multiple commits belonging to a given change, please squash the commits.
+
+Also make sure one pull request covers only **one** topic.
+
+### Commits
+
+Before making a commit, configure your name and email locally using:
+
+```bash
+git config --global user.name "Your Name"
+git config --global user.email "[email protected]"
+```
+
+Then make sure the email you've just configured corresponds to the one you have [set on GitHub](https://docs.github.com/en/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/adding-an-email-address-to-your-github-account).
+
+After this, make your changes, `git add` them and then commit them using `git commit -s`.
+Always sign your commits using the `-s` / `--signoff` arguments to `git commit`.
+This will add the following line at the end of the commit message:
+
+```text
+Signed-off-by: Your Name <[email protected]>
+```
+
+Notice that the details above are the name and email that you configured earlier.
+
+Now the `git commit` command will open your default editor and ask you to write a commit message.
+Prefix each commit message name with the chapter and content type it belongs to, e.g. `use-deliver/reading`, `curate-maintain/media`.
+Following the prefix, write a short and expressive title on the first line.
+Use commit messages with verbs at imperative mood: "Add README", "Update contents", "Introduce feature".
+
+Leave an empty line, then add a relevant description of the changes made in that commit.
+This description should include why that change is needed (fixes a bug, improves something that was inefficient, etc.).
+Wrap the lines of this description to 75 characters.
+How a good commit message should look like: <https://cbea.ms/git-commit/>
+Below is an example of a good commit message:
+
+```text
+template-chapter/drills: Fix Makefile `CFLAGS` error
+
+`CFLAGS` was incorrectly set to optimise the code to the `-O3` level. This
+caused the function `vulnerable_func()` to be inlined into the caller
+`main()`, making it impossible to overwrite `main()`'s return address with
+that of `vulnerable_func()`. This commit fixes the issue by forcing the
+compiler to not optimise the code by replacing `-O3` with `-O0` in `CFLAGS`
+
+Signed-off-by: Your Name <[email protected]>
+```

README.md

@@ -1,5 +1,13 @@
 # `OpenEdu` Methodology Repository
 
+[![copying.md](https://img.shields.io/static/v1?label=license&message=CCBY-SA4.0&color=%23385177)](https://github.com/open-education-hub/methodology/blob/master/COPYING.md)
+[![copying.md](https://img.shields.io/static/v1?label=license&message=BSD-3-clause&color=%23385177)](https://github.com/open-education-hub/methodology/blob/master/COPYING.md)
+[![discord](https://img.shields.io/badge/users-93-7589D0?logo=discord)](www.bit.ly/OpenEduHub)
+[![contributors](https://img.shields.io/github/contributors/open-education-hub/methodology)](https://github.com/open-education-hub/methodology/graphs/contributors)
+[![reddit](https://img.shields.io/reddit/subreddit-subscribers/OpenEducationHub?style=social)](https://www.reddit.com/r/OpenEducationHub/)
+[![twitter](https://img.shields.io/twitter/url?style=social&url=https%3A%2F%2Ftwitter.com%2FOpenEduHub)](https://twitter.com/OpenEduHub)
+[![youtube](https://img.shields.io/youtube/channel/views/UCumS6d-kaVXreY46eZLtEvA?style=social)](https://www.youtube.com/@OpenEduHub/)
+
 The Open Education Hub methodology presents the resources and guides to developing, using and maintaining digital educational content repositories.
 The methodology is anchored in the use of the open source development model and in developing open educational resources (OER).
 These are open educational resources ([OER](https://en.wikipedia.org/wiki/Open_educational_resources)).

REVIEWING.md

@@ -0,0 +1,17 @@
+# Reviewing Contributions
+
+These are recommendations when reviewing contributions to the Open Education Hub Methodology repository.
+Contributions will mostly take the form of GitHub pull requests (PRs);
+issues and discussions are expected as well.
+
+When reviewing contributions, please be civil and welcoming towards contributors.
+Contributions may not be in the best shape initially, but we appreciate time and effort spent in doing this.
+
+Make sure contributions follow the [contribution guide](CONTRIBUTING.md): proper formatting, proper wording, proper styling.
+See if the contributions fit into the scope of the repository and solve a problem or add value to it.
+
+If a contribution is OK, please approve it.
+In case of a reviewed and approved PR, the assignee will then `Rebase and merge` the PR.
+
+If a contribution needs work, please make the appropriate comments.
+For a PR use discussion comments, or comments on the code / text, or directly [suggest changes](https://thenextweb.com/news/github-launches-suggested-changes-to-make-it-easier-to-collaborate-within-pull-requests).