diff --git a/content/brainhack/brainhackproject.md b/content/brainhack/brainhackproject.md index 24ec5fa6..39a92cf5 100644 --- a/content/brainhack/brainhackproject.md +++ b/content/brainhack/brainhackproject.md @@ -88,3 +88,78 @@ Looking for example of project? You can find that from the past Brainhack School + +## Project Submission Guide +To submit your project, you should (1) upload your slides of wrap-up presentation, and have (2) a public repository that contains your deliverables, such as code and report (or Jupyter notebook). Then, you should (3) prepare a introductory page and send a pull request to [Brainhack School project pages](https://school-brainhack.github.io/project/).**NEW! (4) Post your project (GitHub repository link and same introductory page) to the BHS International Discord server "Project- 2025"** + +## Step 1: Upload your slides +Please upload your slides [here](https://drive.google.com/drive/folders/1ToaThg46__bcNoiqcG-aPN_kqlEmDtbM) + +## Step 2: Prepare a public repository on Github for your project +1. On your Github, create a public repository named `_project`, and initialize with a `README` and `LICENSE` file. (You already did this step in Git and Github module.) + +2. Clone your remote repository to your local drive. For example, I would like to clone the files on the repository to my `Documents` folder under home directory, I can type the following code in terminal. Then, I shall found the files under `~/Documents/_project`. + ``` + cd ~/Documents + # change the to your github account, and to your name on your Github repository + git clone https://github.com//_project.git + cd _project + ``` + +3. Open the `README.md` file. Copy and paste all the contents from [Brainhack School Project template](https://raw.githubusercontent.com/brainhack-school2023/project_template/main/README.md). Follow the template and modify the text to show the necessary details for your project. This `README.md` is a markdown file, so you should prepare it as markdown format, then Github and our website will render this markdown file on webpage as shown [here](https://github.com/school-brainhack/project_template) and [here](https://school-brainhack.github.io/project/template/). You can learn more about markdown format [here](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax), [here](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet), and [here](https://www.markdowntutorial.com/). **Please ensure your page header is in markdown format, starting with three dashes (---) in the first row.** You can embed your result figures in the README.md. However, please note that you should copy your figure files into the same folder and use the relative path to embed your figures. + +4. Copy all your deliverables into this folder, stage and commit your changes and push to repository. You have to input your Github username and [personalized token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens) as password when it prompt. + ``` + # You should copy all your deliverables to this folder before these lines + # Otherwise, none of your files were uploaded + git add -A + git commit -m "upload my deliverables" + git push -u origin main + ``` + +5. Check your repository, you should find that all your deliverables were uploaded and `README.md` was updated. + +7. Please fill out the [form](https://docs.google.com/forms/d/e/1FAIpQLSf-6_cvIzuIk_1aVq_4zaeZAVpfB0ZJf7hNVmewbxgnh3C3aA/viewform) here to let us know the links for your repository and slides. We will evaluate your performance accordingly. + +## Step 3: Fork the website and send a pull request for your project +1. Go to the [Github repository for Brainhack School website](https://github.com/school-brainhack/school-brainhack.github.io). Click the `Fork` on the page to fork this repository to your account. +![](/brainhack/submfigures/subm1.png) + +2. Leave everything as defaults, and click `create fork`. +![](/brainhack/submfigures/subm2.png) + +3. You should see that you forked the repository to your account. +![](/brainhack/submfigures/subm3.png) + +4. Clone the forked repository to your local drive. Here, we demonstrated how to clone the repository to `Documents` folder. + ``` + cd ~/Documents + # change the to your github account + git clone https://github.com//school-brainhack.github.io.git + cd school-brainhack.github.io + ``` + +5. In the school-brainhack.github.io folder, navigate to school-brainhack.github.io/content/en/project +![](/brainhack/submfigures/subm4.png) + +6. Create a folder for your project. The folder name should not have a space! You should replace any spaces with _. Then, copy your README.md (and your figure files if you embedded them in README) to the folder. Importantly, please **rename the README.md to index.md.** +![](/brainhack/submfigures/subm5.png) + +7. Stage, commit and push to your forked repository. + ``` + # change the to the folder name for your project + cd content/en/project + git add ./ + git commit -m "upload a page for my project" + git push -u origin main + ``` + +8. You should see that you commit the changes for your project on the forked repository. +![](/brainhack/submfigures/subm6.png) + +9. Then, get back to the original [Github repository for Brainhack School website](https://github.com/school-brainhack/school-brainhack.github.io). We will send a pull request. (step 1:) First, click the pull request, (step 2:) then click an option called compare across forks, (step 3:) select your /school-brainhack.github.io.git as the head repository. (step 4:) Check all the commits are correct. (step 5:) Then the final step is click the create pull request and confirm the pull request. +![](/brainhack/submfigures/subm7.png) + +10. We will review your pull request, and some revisions might be needed. Please be patient and help us to revise your request accordingly. + + diff --git a/content/brainhack/submfigures/subm1.png b/content/brainhack/submfigures/subm1.png new file mode 100644 index 00000000..f66bf38b Binary files /dev/null and b/content/brainhack/submfigures/subm1.png differ diff --git a/content/brainhack/submfigures/subm2.png b/content/brainhack/submfigures/subm2.png new file mode 100644 index 00000000..05fa5bdd Binary files /dev/null and b/content/brainhack/submfigures/subm2.png differ diff --git a/content/brainhack/submfigures/subm3.png b/content/brainhack/submfigures/subm3.png new file mode 100644 index 00000000..36d62605 Binary files /dev/null and b/content/brainhack/submfigures/subm3.png differ diff --git a/content/brainhack/submfigures/subm4.png b/content/brainhack/submfigures/subm4.png new file mode 100644 index 00000000..1ddb5ab7 Binary files /dev/null and b/content/brainhack/submfigures/subm4.png differ diff --git a/content/brainhack/submfigures/subm5.png b/content/brainhack/submfigures/subm5.png new file mode 100644 index 00000000..99fa31e4 Binary files /dev/null and b/content/brainhack/submfigures/subm5.png differ diff --git a/content/brainhack/submfigures/subm6.png b/content/brainhack/submfigures/subm6.png new file mode 100644 index 00000000..adafa6b4 Binary files /dev/null and b/content/brainhack/submfigures/subm6.png differ diff --git a/content/brainhack/submfigures/subm7.png b/content/brainhack/submfigures/subm7.png new file mode 100644 index 00000000..fe485396 Binary files /dev/null and b/content/brainhack/submfigures/subm7.png differ