assignment 1

_toc.yml

@@ -18,7 +18,7 @@ parts:
   - caption: Assignments
     numbered: True
     chapters:
-    - file: assignments/index
+    - file: assignments/01-syllabus-install
   - caption: Portfolio
     chapters:
       - file: portfolio/index

assignments/01-syllabus-install.md

@@ -0,0 +1,110 @@
+---
+substitutions:
+  accept_assignment: |
+    [accepting the assignment](https://classroom.github.com/a/oIJowjlW)
+  date : 2023-01-30
+---
+# Assignment 1: Portfolio Setup, Data Science, and Python
+
+__Due: {{ date }}__
+
+
+
+Eligible skills: (links to checklists)
+- {fa}`star`[^starredskill]  python [level 1](https://rhodyprog4ds.github.io/BrownFall22/syllabus/achievements.html#python-level1) and [level 2](https://rhodyprog4ds.github.io/BrownFall22/syllabus/achievements.html#python-level2)
+- {fa}`star`process[^processnote] [level 1](https://rhodyprog4ds.github.io/BrownFall22/syllabus/achievements.html#process-level1) 
+
+[^starredskill]: skills will be marked like this on the first time they are eligible. There will also be a {fa}`hourglass-end`  on skills for the last assignment they are eligible
+[^processnote]: process is a special skill. You'll earn level 1 in this assignment or a soon one and two in either portfolio 1 or assignments 6-10, then level 3 in portfolio 2,3, or 4. 
+
+## Related notes
+
+- [](../notes/2023-01-24)
+- [](../notes/2023-01-26)
+## To Do
+
+````{margin}
+```{note}
+If you get stuck on any of this after accepting the assignment and creating a repository, you can create an issue on your repository, describing what you're stuck on and tag us with `@rhodyprog4ds/{{ ghinstructors }}`.
+
+To do this click Issues at the top, the green "New Issue" button and then type away.
+```
+````
+
+```{important}
+If you have trouble, check the GitHub FAQ on the left before e-mailing
+````
+
+Your task is to:
+1. Install required software from the Tools & Resource page
+1. Create your portfolio, by {{ accept_assignment }}
+1. Learn about your portfolio from the README file on your repository.
+1. edit `_config.yml` to set your name as author and  change the logo if you wish
+1. Fill in `about/index.md` with information about yourself(not evaluated, but useful) and your own definition of data science (graded for **level 1 process**)
+1. Add a Jupyter notebook called `grading.ipynb` to the `about` folder and write a function that computes a grade for this course, with the  docstring below.
+1. Add the line `  - file: about/grading` in your `_toc.yml` file.
+
+```{important}
+Do not merge your "Feedback" Pull Request
+````
+
+### Docstring
+```
+    '''
+    Computes a grade for CSC/DSP310 from numbers of achievements at each level
+
+    Parameters:
+    ------------
+    num_level1 : int
+      number of level 1 achievements earned
+    num_level2 : int
+      number of level 2 achievements earned
+    num_level3 : int
+      number of level 3 achievements earned
+
+    Returns:
+    --------
+    letter_grade : string
+      letter grade with possible modifier (+/-)
+    '''
+```
+
+### Sample tests 
+Here are some sample tests you could run to confirm that your function works correctly:
+````{margin}
+```{warning}
+remember the difference between side effects and returns
+```
+
+
+```{note}
+when the value of the expression after `assert` is `True`, it will look like nothing happened. `assert` is used for testing
+```
+````
+
+```
+assert compute_grade(15,15,15) == 'A'
+
+assert compute_grade(15,15,13) == 'A-'
+
+assert compute_grade(15,14,14) == 'B-'
+
+assert compute_grade(14,14,14) == 'C-'
+
+assert compute_grade(4,3,1) == 'D'
+
+assert compute_grade(15,15,6) =='B+'
+```
+
+### Notebook Checklist 
+
+ -  a Markdown cell with a heading
+ - your function called `compute_grade`
+ - three calls to your function that verify it returns the correct value for different number of badges that produce at three different letter grades.
+
+### Grading Notes: 
+
+ - a basic function that uses conditionals in python will earn **level 1 python**
+ - to earn **level 2 python** use pythonic code to write a loop that tests your function's correctness, by iterating over a list or dictionary. Remember you will have many chances to earn level 2 achievement in python, so you do not need to do this step for this assignment if you are not sure how. 
+
+

faq/syllabus.md

@@ -10,6 +10,12 @@ However, if you do not submit (or earn no achievements from) assignments or port
 If you do not submit (or earn no achievements from) your portfolio, the maximum grade you can earn is a B.
 ```
 
+(duetime)=
+## What time are assignments due? 
+```{toggle}
+End of day.  I could start grading at any time the next morning.  If your work is not there when I start grading it will not be graded, but if it is, I won't check the time stamp. 
+```
+
 
 ## Can I submit this assignment late if ...?
 ```{toggle}