|
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