centralize the information about reading like a blog post

Author: afeld

assignments/open_ended.md

@@ -12,6 +12,16 @@ In [Homework 1](../hw_1.md), [Homework 4](../hw_4.md), and the [Final Project](.
 - If you'd be interested in working with [SIPA alumni employment data](https://www.sipa.columbia.edu/pathways-careers/employment-statistics), [reach out to the instructor](../syllabus.md#instructor-information).
 {%- endif %}
 
+## Read like a blog post
+
+For these assignments:
+
+- Pretend you're explaining to a peer who hasn't taken this class. You don't need to teach them to code, but they should be able to follow what's going on.
+- Walk the reader through what you're doing in every step and what they should be taking away from it.
+  - You are more than welcome to inject personality in there; doesn't need to be dry.
+- Use text cells with [Markdown](https://www.markdownguide.org/basic-syntax/) for formatting.
+  - You'll need to [change the cell type to Markdown](https://jupyter-notebook.readthedocs.io/en/stable/examples/Notebook/Working%20With%20Markdown%20Cells.html#Markdown-Cells).
+
 ## Open data portals
 
 There are countless places to get data, notably:

final_project.md

@@ -22,13 +22,8 @@ In addition to the applicable [general assignment requirements](syllabus.md#assi
 
 <!-- make sure edits here are reflected in extras/scripts/final_project_check.py -->
 
-- **Read like a blog post** - 35 points
-  - Pretend you're explaining to a peer who hasn't taken this class. You don't need to teach them to code, but they should be able to follow what's going on.
+- [**Read like a blog post**](assignments/open_ended.md#read-like-a-blog-post), and do the following - 35 points
   - Re-state the [question, hypothesis, and data source(s) with link(s)](final_project/proposal.md#format)
-  - Walk the reader through what you're doing in every step and what they should be taking away from it.
-    - You are more than welcome to inject personality in there; doesn't need to be dry.
-  - Use text cells with [Markdown](https://www.markdownguide.org/basic-syntax/) for formatting.
-    - You'll need to [change the cell type to Markdown](https://jupyter-notebook.readthedocs.io/en/stable/examples/Notebook/Working%20With%20Markdown%20Cells.html#Markdown-Cells).
   - If you hit any dead ends in your analysis, leave them in.
     - For example, include charts that you generate that may not show anything interesting and explain what you are choosing to look at instead.
     - You should still be cleaning up unused/broken code to make your notebook readable.

hw_1.md

@@ -12,7 +12,7 @@
 
 ## Coding
 
-You'll do the following in a notebook. Make it read like a blog post. Pretend you're explaining to a peer who hasn't taken this class. You don't need to teach them to code, but they should be able to follow what's going on.
+You'll do the following in a notebook. Make it [read like a blog post](assignments/open_ended.md#read-like-a-blog-post). Pretend you're explaining to a peer who hasn't taken this class. You don't need to teach them to code, but they should be able to follow what's going on.
 
 ### Steps
 

hw_4.md

@@ -30,6 +30,7 @@ Here is [a thorough example](final_project/universities.ipynb) - yours does _not
 - The relationship you're showing doesn’t need to be something novel; replicating something you saw / read / heard about is fine.
 - This can overlap the [Final Project](final_project.md), but should be different.
   - Per [the requirements](assignments/open_ended.md), it should use at least one dataset you haven't used for your Final Project or anything else.
+- Make it [read like a blog post](assignments/open_ended.md#read-like-a-blog-post).
 - State the takeaway(s)
 - Did you use an [external source](syllabus.md#academic-integrity), including generative AI? Please explain, or say that you didn't.
 

syllabus.md

@@ -184,8 +184,9 @@ It is entirely possible for everyone in the class to get over 100%.
 - **Incomplete Steps / Steps with logic errors:** -2 to -5 points
 - [**Visualizations incomplete, e.g. missing meaningful title/labels:**](https://python-public-policy.afeld.me/en/{{school_slug}}/lecture_3.html#chart-hygiene) -3 points
 - **Unattempted Steps:** -10 points
+- **Homework [1](hw_1.md)/[4](hw_4.md) doesn't [read like a blog post](assignments/open_ended.md#read-like-a-blog-post):** -10 to -20 points
 
-If the submission showed effort, written feedback will be provided.
+If the submission showed effort, written feedback will be provided through Gradescope.
 
 #### [Final Project](final_project.md)