How to submit assignments for CS180/CS280A.

For each assignment, you will be required to submit two deliverables to Gradescope and share your website link via Google Form to showcase your work alongside your classmates.
Please upload a .zip adhering to the following structure:


    submission.zip

    ├─code/

    │ ├─main.ipynb   # or main.py

    │ ├─utils.py     # generic example file, not needed

    │ └─README.txt   # or markdown

    └─web/

      ├─page.pdf 

      └─sites.txt

1. Code

You should upload code only to Gradescope. Do not host your code publicly.

All of your project code should be contained in some main.py or main.ipynb that the grader(s) can run to reproduce your results. If you have a complex workflow, make sure to upload all the necessary files and include a README.txt file describing how we can run your code.
Please be sure to appropriately comment your code so that the graders can appropriately identify where your implementations lie and what they do.
Place all of your coding files in the code/ directory. They should be distinct from your web files.

2. Webpage Report

If you do not already have a webpage set up, we recommend using GitHub Pages (tutorial).

You should upload a web/ folder containing two files: page.pdf and sites.txt.
page.pdf should be a PDF of your webpage (i.e. printing the page and saving it as a PDF).
- If your page contains animations/interactivity that cannot be captured in a PDF, please note this in the report.
- You may consider compressing the PDF file if you hit the 100Mb size limit (e.g. with this)
sites.txt should be a have two lines (and nothing else!):

Webpage report URL (may look like https://[gh-user].github.io/[proj#]/ ─ or ─ https://[gh-user].github.io/[repo-name]/[proj#]/ )
GitHub repo URL (may look like https://github.com/[gh-user].github.io/ ─ or ─ https://github.com/[gh-user]/[repo-name]/ )
- This must be a public repo
- NO CODE should be hosted here, or any where else public.

If you have any comments, even if they're about web and not code, please include them in ./code/README.txt

3. Google Form

Share your website link through the Google Form to showcase your project alongside your classmates' work! This creates a public gallery where everyone can explore each other's projects. The form link will be posted on each respective project page.