# Template

## Introduction

**Motivate** and introduce the content and context of your notebook. **Why** are you creating this notebook? **What** will you teach? **Why** should the reader care?

### Naming Conventions

Your notebook name should be kebab-case and it should not contain your Jira task identifier. If your notebook is in a directory, your directory should have the same name as your notebook but in UpperCamelCase. All files should have descriptive names.

### Banners

The markdown to display the banner in the header should be

`![Callysto.ca Banner](https://github.com/callysto/curriculum-notebooks/blob/master/callysto-notebook-banner-top.jpg?raw=true)`

and in the footer

`[![Callysto.ca License](https://github.com/callysto/curriculum-notebooks/blob/master/callysto-notebook-banner-bottom.jpg?raw=true)](https://github.com/callysto/curriculum-notebooks/blob/master/LICENSE.md)`

### Organization

If you have files accompanying your notebook they should be in a directory along with your notebook. Images should all be in an `images` folder, with the exception of the [header](https://github.com/callysto/curriculum-notebooks/blob/master/callysto-notebook-banner-top.jpg?raw=true) and [footer](https://github.com/callysto/curriculum-notebooks/blob/master/callysto-notebook-banner-bottom.jpg?raw=true).

### Background

Include the background information about your content. Include examples and explanation to help guide your notebooks.

#### Examples

Use Python or your own explanations to provide **examples and interactivity** to help teach and showcase the concepts to the student.

#### Questions

Ask questions throughout your document to **keep the student engaged** and thinking about the content you've provided.

## Conclusion

Summarize your notebook. **Reiterate** the lesson and important takeaways.

### Sample Template Notebook

Refer to [this link](https://github.com/callysto/notebook-templates/blob/master/templates/Notebook_Template_With_TableContents.ipynb) to access a template notebook with magics, table of contents, banners, sample questions, headers and subheaders matching the bare bones template in this section.

**Does your notebook contain all these items? If not be sure to add them.**

After completing your notebook(s) and content review, make the recommended changes and open a pull request from your branch to master.


---

# 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://training.callysto.ca/notebook-design/notebook-template.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.