# How to create an issue

Use Stepsize to create better, **more actionable** issues right here in your code editor.

Traditional issues lack context and visibility. Stepsize issues have powerful context built in from the start, and are visible throughout your software development cycle. All without leaving your codebase.

## **How to create an issue in your editor** 🪄

1. **Select** the snippet of code you want to create an issue from
2. **Use the shortcut `[^/I]`** to create your issue, or right click and select `Create a technical issue`
3. **Add context** to your issue, such as a title, description, and impact
4. Hit `Create issue` to finish creating your issue

   <figure><img src="https://res.cloudinary.com/drvhrxrne/image/upload/v1670854755/samples/product_guides/Create_new_issue_s52z1b.gif" alt=""><figcaption></figcaption></figure>

Congratulations! You've created a Stepsize issue. You can now see the Stepsize inline annotation indicating that there is an issue attached to this snippet of code.

![Creating your issue](https://res.cloudinary.com/drvhrxrne/image/upload/v1669989064/samples/product_guides/Screenshot_2022-12-02_at_13.50.26_gfk7mm.png)

{% hint style="success" %}
None of your code goes into the Stepsize cloud. The Stepsize integrations have been designed with privacy in mind. [See our Information Security Guide](https://storage.googleapis.com/stepsize-assets/Stepsize%20Information%20Security.pdf) for more detail.
{% endhint %}

<br>

## **Creating an issue from a pull request** 🌱

You can create issues from pull requests.

Start your comment with `[stepsize]` to create an issue from a `diff`.

The issue will be automatically linked to the code it relates to, both in your code editor and in the web app.

{% hint style="info" %}
This is a great way to track improvements that come up during review that you don't have time to take care of before merging.
{% endhint %}

## **What next?**

Stepsize issue are inherently linked to code. You can link multiple snippets, files or folders.

Let's learn how to add more code and context to your issues.


---

# 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://stepsize.gitbook.io/stepsize-documentation/issues/how-to-create-an-issue.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.