Skip to content

Commit a4e5387

Browse files
committed
Add ReadMe and contribution guidelines
1 parent c585f53 commit a4e5387

File tree

1 file changed

+55
-1
lines changed

1 file changed

+55
-1
lines changed

README.md

+55-1
Original file line numberDiff line numberDiff line change
@@ -1 +1,55 @@
1-
# Course Supplementary Materials
1+
# AI Educational Materials
2+
3+
4+
<p align="center">
5+
<a href="#how-to-contribute">How to Contribute</a> •
6+
<a href="#license">License</a>
7+
</p>
8+
<p align="center" markdown="1">
9+
<a href="https://github.com/sut-ai/supplementary/actions/workflows/main.yml" >
10+
<img src="https://github.com/sut-ai/supplementary/actions/workflows/main.yml/badge.svg?branch=master" alt="Webify & Deploy">
11+
</a>
12+
</p>
13+
14+
This repository contains reading lists and other educational materials regarding artificial intelligence. Sample educational posts (markdown/notebooks) are welcome to be added.
15+
16+
## How to Contribute
17+
Right now we only accept educational notebooks, if you want to submit your notebook, do as follows:
18+
1. First [fork this repository](https://github.com/sut-ai/supplementary/fork)!
19+
2. Create a new folder in `notebooks/` (please follow lower-cased underline seperated naming convention for your folder).
20+
3. Create your notebook inside your newly created folder and name it `index.ipynb`. Make sure that all the necessary files (images and other potential assets) are all located inside this folder. Make sure that all your assets are referenced relative from your notebook.
21+
4. Create `matadata.yml` inside your notebook and fill in these informations:
22+
23+
```yml
24+
title: <change this> # shown on browser tab
25+
26+
header:
27+
title: <change this> # title of your notebook
28+
description: <change this> # short description of your notebook
29+
30+
authors:
31+
label:
32+
position: top
33+
content:
34+
# list of notebook authors
35+
- name: <change this> # name of author
36+
role: Author # change this if you want
37+
contact:
38+
# list of contact information
39+
- link: https://github.com/<your_github_username>
40+
icon: fab fa-github
41+
# optionally add other contact information like
42+
# - link: <change this> # contact link
43+
# icon: <change this> # awsomefont tag for link (check: https://fontawesome.com/v5.15/icons)
44+
45+
comments:
46+
# enable comments for your post
47+
label: false
48+
kind: comments
49+
```
50+
You can look at the [already merged notebooks](https://github.com/sut-ai/supplementary/tree/master/notebooks) to find example metadata and folder structures. To learn more about further customizations please consult the [Webifier](https://github.com/webifier/build/) documentations.
51+
5. Add your notebook directory name to the list of notebooks in `notebooks/index.yml`
52+
6. After making sure that you've done everything correctly, proceed to open a pull request with your notebook directory name as the subject.
53+
54+
## License
55+
MIT License, see [supplementary/LICENSE](https://github.com/sut-ai/supplementary/blob/master/LICENSE).

0 commit comments

Comments
 (0)