> For the complete documentation index, see [llms.txt](https://good-alchemy.gitbook.io/fabric-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://good-alchemy.gitbook.io/fabric-documentation/getting-started.md).

# Getting Started

How to get started with Fabric and create your first issue

### What is Fabric?

Welcome to Fabric and the Fabric Docs! This section of the docs is dedicated to helping you get familiar with Fabric and create your first issue. Check out the rest of the [Fabric Documentation](/fabric-documentation/readme.md) to learn more about Fabric and how to get the most out of it.

### Creating Your First Issue

There are many ways to create an issue with Fabric such as with a [slash command](/fabric-documentation/reference/issues.md#with-a-slash-command), [from an existing message](/fabric-documentation/reference/issues.md#from-an-existing-message), or by reacting to a Slack message [with the 🆕 emoji](/fabric-documentation/reference/issues.md#using-the-emoji-reaction). For this example, we’re going to create an issue using the /issue slash command to pull up the Slack shortcut. You can either just type `/issue` or type the name of the issue you want to create and it will be prefilled as the title. i.e. `/issue Add a short GIF to the templates page`

![creating an issue with /issue](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/jOfUX1bHVy8jdOYSlUWg/CleanShot%202021-08-19%20at%2014.15.28.gif)

This will bring up a modal where you can either create an issue from [an existing template](/fabric-documentation/reference/templates.md) or create one from scratch. Here you’ll be able to choose a repository to send the issue to, add a description, assignees, labels and select the channel you want the issue to be sent to.

![Creating an issue from a template](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/ygSRnhhzIsDlXfxZhab2/template%20gif.gif)

Your issue will be added to the chosen repository and any changes you make will sync seamlessly between GitHub and Slack.

In the [channel you sent the issue to](/fabric-documentation/reference/issue-feeds.md), you can continue to [edit the issue](/fabric-documentation/reference/issues.md#editing-issues) such as modifying the description and adding additional assignees.

![Here you can edit an issue after it's been created](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/EAcCJm6pl4LhJvgCOg1O/image.png)

### Making An Issue Room

To really make the most of Fabric, we recommend creating “[Issue Rooms](/fabric-documentation/reference/issue-rooms.md)” to work on your issues. Issue Rooms are dedicated slack channels where you can add collaborators and have every message, image, etc. sync seamlessly between Slack and GitHub.

Issue Rooms can be created [automatically](/fabric-documentation/reference/issue-rooms.md#creating-automatically) or manually. To create an issue room manually, select “Create Issue Room” and Fabric will automatically create a dedicated Slack channel with a unique prefix.

![creating an issue room](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/7XimW7lHRqa7nGq8J78d/CleanShot%202021-08-19%20at%2014.26.51.gif)

### Closing Your First Issue

When you’re finished working on your issue in an issue room, you can [close it easily](/fabric-documentation/reference/issue-rooms.md#close) without ever having to leave Slack. All you need to do is type and send “close” (just the word, not as a slash command) and Fabric will take care of the rest. Fabric will close the issue on Slack and GitHub as well as archive the Issue Room.

![closing an issue](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/4gN1PFHSRE9LsuiWmFu2/CleanShot%202021-08-19%20at%2014.45.42.gif)

Explore the docs to learn more about Fabric and how to customize it to your team’s preferences!