# Distributing Homework

## Workflow Overview

![Assignment workflow](/files/kz9RySMGgw5szlBwJ1FN)

## Distributing Homework

To create assignments, visit your classroom home and select upper right button to create a new assignment

![](/files/2k1YdzXqyiWTYjGqGTj8)

### Considerations

* Choose appropriate level of privacy: Private or public
* Give students admin on their repo. That means they could invite other people to it, make it public etc
* Select starter code from a pre-existing repository

![](/files/rqloRdjIkqDHpLI9r13H)

### Distribute homework link

![](/files/cJ5faaHgiQjMM5ABhTKo)

## Grading and Feedback

After the submission deadline, there are several workflows you can follow. Here we outline few suggestions and we invite you to contribute, your own workflows.

Clone all homework repositories (with and automated script - coming soon), then:

Possible ways of generating feedback include:

### General Comments:

* README
* CANVAS

### Inline comments:

* Write markdown cells inside the hub - commit and push
  * Student views inside jupyterhub
  * Could use [https://www.reviewnb.com/](https://www.reviewnb.com/#features) for nicer diff
* Write to a script .py that is kept insync
  * Student views inside github
* PDF feedback via CANVAS


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ccv.brown.edu/archive/jupyterhub/github-classroom-instructor-guide/set-up-your-classroom.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
