> For the complete documentation index, see [llms.txt](https://docs.tychos.org/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tychos.org/docs/for-teachers/giving-feedback-comments.md).

# Giving Feedback: Comments

Giving focused feedback is a key to helping students understand how they can improve. Tychos gives teachers the ability to leave comments in student code, attaching the comment to a specific line of code.

### Step 1: Click on the line number

In the code editor (either the Setup Code pane, or the Loop Code pane) you simply click on the line number to open up the comment dialog:

<figure><img src="/files/bL23JFfBCOYFBQZ8mjj4" alt=""><figcaption></figcaption></figure>

### Step 2: Enter your comment

You will be prompted to enter some text. This will be viewable by the student. You can also edit this comment, or remove it by cliking on the line number again:

<figure><img src="/files/vHVMfjTTEeJmIPrBUhj4" alt=""><figcaption></figcaption></figure>

### Step 3: Save the scenario, student can now view

Once you have added the comment, be sure to SAVE the scenario. This will add the comment to the student's scenario so that they can view it. The student views the comment by simply hovering the mouse over the icon that appears now to the left of the line number - a little green comment icon indicator:

<figure><img src="/files/Q8hODPCZDkWC2rXJ5JnP" alt=""><figcaption></figcaption></figure>

The student can remove the comment by clicking on the little trash can icon.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.tychos.org/docs/for-teachers/giving-feedback-comments.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
