# Fabric for bugs

Have a lot of messages coming into your `#bugs` channel? Want to make it easier for others to create issues without asking you?

![Fabric templates makes your #bugs channel a lot more manageable.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/OpvYJrkdW09Sfx8OlJvi/Screen%20Shot%202021-09-17%20at%205.53.24%20PM.png)

[**Fabric's**](https://www.tryfabric.com/) **got you covered!**

> "It's [so easy to create an issue from the conversation](https://good-alchemy.gitbook.io/fabric-documentation/reference/issues#from-an-existing-message) that that I never see somebody working on something in Slack where there's no issue" **- Tyler Richie, CTO of Sprout**

![Click "Create an issue" on a message or react with 🆕 to create an issue.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/cQEvCsMYVVvcpqGxoeF1/Screen%20Shot%202021-09-16%20at%203.10.35%20PM.png)

In just a few clicks, Fabric can create an issue in GitHub, add relevant details, and optionally spin up a channel for teammates to collaborate.

Work fluidly in Slack, and we'll make sure everything gets to the right place.

## Create and fix bugs faster

With our customizable workflow, any user can [create an issue](https://good-alchemy.gitbook.io/fabric-documentation/reference/issues#creating-issues) out of one or multiple Slack messages.

The bug [template](https://good-alchemy.gitbook.io/fabric-documentation/reference/templates) takes care of filling out the issue, including applying any labels or assignees.

We can even [automatically open an Issue Room](https://good-alchemy.gitbook.io/fabric-documentation/reference/issue-rooms#turn-auto-creation-on-per-template) for each bug. This gives the requester plenty of space to drop in more details or screenshots, which the engineer can use to fix the bug.

### Create your issue

#### Create from a message

Click on a message to [create an issue](https://good-alchemy.gitbook.io/fabric-documentation/reference/issues#creating-issues). You can import multiple messages. We support emojis, images, files, and threads, so all the context is captured.

![Click "Create an issue" on a message or react with 🆕 to create an issue.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/cQEvCsMYVVvcpqGxoeF1/Screen%20Shot%202021-09-16%20at%203.10.35%20PM.png)

#### Choose your template

When you link your `#bugs` channel to a template as an [Issue Feed,](https://good-alchemy.gitbook.io/fabric-documentation/reference/issue-feeds) we recommend that template in the channel.

This makes it really fast for teammates to find the right template.

![We'll prompt the user to select the template linked to the channel.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/1UpNQxChLTZXN1XqANuy/Screen%20Shot%202021-09-16%20at%203.11.09%20PM.png)

#### Fill out your issue

![The message is imported into the title and description, along with the template prompt.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/K46NSpDWhTdxqcxYEfGE/Screen%20Shot%202021-09-16%20at%203.19.33%20PM.png)

#### Anyone can add more details

You can add more details to your issue, and then click `Done editing` to collapse it.

![Add assignees, labels, a milestone, or a project column.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/gkxL3d9WSosQdfylaH58/Screen%20Shot%202021-09-17%20at%205.29.29%20PM.png)

#### Finish triaging your issue

When you're done adding details to your issue, it collapses.

When your issue is updated anywhere, this message will update with the new details.

![When you're done adding details to your issue, it collapses.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/v4en6T7zbodigcMjYaH4/screen-shot-2021-09-17-at-5.32.40-pm%20\(1\).png)

### Collaborating with Issue Rooms

[Issue Rooms](https://good-alchemy.gitbook.io/fabric-documentation/reference/issue-rooms) let you collect more information and collaborate with more people, to close out bugs faster.

#### Let us spin up a channel for your issue

When you're creating your [bug template,](https://good-alchemy.gitbook.io/fabric-documentation/recommended-templates/bug-report) say `Yes` to `Auto-create an Issue Room for every new issue?`.

![Toggle the auto-creation setting to "yes" to create Issue Rooms automatically.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/Gh2e8NCVeyqvzbvSsuAZ/CleanShot%202021-09-17%20at%2017.42.28@2x.png)

This will **attach an Issue Room channel** to the bottom of each bug you create.

![We create the Issue Room for you and attach it to your issue.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/B0aTpIblmwt0ZPo4qsKS/Screen%20Shot%202021-09-17%20at%205.32.40%20PM.png)

#### Engineers and non-engineers, talking together

Team members outside of engineering are often intimidated by GitHub, and won't collaborate in there. But they will in Slack.

With Issue Rooms, every message gets backed up to the GitHub issue, so engineers and those on the business side end up collaborating more closely.

![Teammates across roles can collaborate easily in an Issue Room.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/XDrQABY9qYJGmH8dEiQN/Screen%20Shot%202021-09-17%20at%205.47.28%20PM.png)

#### The channel closes when the issue does

When your issue is closed, we automatically archive your Issue Room for you.

![](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/AYZOVKvy0LDFx02bUYhc/Screen%20Shot%202021-08-28%20at%203.45.02%20PM.png)

## Set up your bug workflow <a href="#how-do-i-set-up-an-incident-template" id="how-do-i-set-up-an-incident-template"></a>

To set up your bug workflow, we'll first create a [bug template,](https://good-alchemy.gitbook.io/fabric-documentation/recommended-templates/bug-report) and connect it to your existing `#bugs` channel as an [Issue Feed.](https://good-alchemy.gitbook.io/fabric-documentation/reference/issue-feeds)

### Go to your Fabric dashboard <a href="#go-to-your-fabric-dashboard" id="go-to-your-fabric-dashboard"></a>

To get to your Fabric dashboard, click `Fabric` under `Apps` in your Slack sidebar.

If you don't see `Fabric` there, search for `Fabric` in your Slack search bar, and then click on the `Home` tab.

![](https://gblobscdn.gitbook.com/assets%2F-MhaDNLIUpkpQasYP_hs%2F-Mho_PCGHjtZUrL9zEFG%2F-MhohIxiHesj4aTv9MFl%2FScreen%20Shot%202021-08-23%20at%204.30.14%20PM.png?alt=media\&token=2d666e87-70c0-4189-92fc-a1799cb7b57b)

Find Fabric in the Slack sidebar or search for it in the Fabric search bar.

![](https://gblobscdn.gitbook.com/assets%2F-MhaDNLIUpkpQasYP_hs%2F-Mho_PCGHjtZUrL9zEFG%2F-MhohP0rcYtALUMlL8RD%2FScreen%20Shot%202021-08-23%20at%204.30.21%20PM.png?alt=media\&token=4bff79f1-53d1-45b5-977e-28c4576b57c9)

This is your Fabric Dashboard.

### Go to your templates page <a href="#go-to-your-templates-page" id="go-to-your-templates-page"></a>

To get to your Templates Page, click on `Templates`.

![](https://gblobscdn.gitbook.com/assets%2F-MhaDNLIUpkpQasYP_hs%2F-Mho_PCGHjtZUrL9zEFG%2F-MhoiJrZrz7lXR39Kqzz%2FScreen%20Shot%202021-08-23%20at%204.35.02%20PM.png?alt=media\&token=3c56265a-4f41-404f-a064-1877c9f641ce)

This is your Templates page.

### Select the bug template <a href="#select-the-incident-sample-template" id="select-the-incident-sample-template"></a>

Let's customize the [bug template.](https://good-alchemy.gitbook.io/fabric-documentation/recommended-templates/bug-report) Click `Create a template from example`.

![](https://gblobscdn.gitbook.com/assets%2F-MhaDNLIUpkpQasYP_hs%2F-Mho_PCGHjtZUrL9zEFG%2F-Mhoj-foVlI9oQ5DD5Eg%2FScreen%20Shot%202021-08-23%20at%204.37.43%20PM.png?alt=media\&token=8f121c94-9c26-447f-847e-bf5e671f66d2)

Choose `🐞 Bug Report`.

![](https://gblobscdn.gitbook.com/assets%2F-MhaDNLIUpkpQasYP_hs%2F-Mholuquddk33GK--eZL%2F-Mhoqflhv_iz021jXB8p%2FCleanShot%202021-08-23%20at%2017.11.31%402x.png?alt=media\&token=5410e1be-9c6b-4955-90fc-cee630765707)

Choose `Start with this one` on the `🐞 Bug Report` Template.

![](https://gblobscdn.gitbook.com/assets%2F-MhaDNLIUpkpQasYP_hs%2F-MhsmTcClNuyB5Pl6VHU%2F-MhsmqldtjdgnnyyLQma%2FCleanShot%202021-08-24%20at%2011.33.16%402x.png?alt=media\&token=e6910241-3053-4b54-9066-4967bac4f275)

Here, you can customize all details of the `🐞 Bug Report` Template.

### Configure your template <a href="#configure-your-template" id="configure-your-template"></a>

Continue setting up your template with these details:

| Setting                           | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name                              | 🐞 Bug Report                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Overview                          | Report a problem you ran into using the product.                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Description                       | <ul><li><code>Briefly describe the bug you ran into.</code></li><li><code>What steps did you take before seeing the bug? The more specific, the better.</code></li><li><code>What did you expect to happen?</code></li><li><code>What was the technical context (i.e. what version of software, browser, operating system, etc.)</code></li><li><code>Please attach any images or files that can help us reproduce (screenshots, screenshares, etc.)</code></li></ul> |
| Repository                        | \<your default repository>                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Default labels                    | `bug`                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Default assignees                 | \<add any default assignees>                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Default project column            | \<add any project column>                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Issue Feed                        | \<add your bugs channel, ex. `#feed-bugs`>                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Create Issue Rooms automatically? | ✅                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Issue Room Prefix                 | `#bug-`                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Show label field?                 | ✅                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Show assignee field?              | ✅                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Show milestone field?             | ❌                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Show project field?               | ✅                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |


---

# 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://good-alchemy.gitbook.io/fabric-documentation/guides/upgrade-your-bugs-channel.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.