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 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, from an existing message, or by reacting to a Slack message with the 🆕 emoji. 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
This will bring up a modal where you can either create an issue from an existing template 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
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, you can continue to edit the issue such as modifying the description and adding additional assignees.
Here you can edit an issue after it's been created

Making An Issue Room

To really make the most of Fabric, we recommend creating “Issue Rooms” 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 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

Closing Your First Issue

When you’re finished working on your issue in an issue room, you can close it easily 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
Explore the docs to learn more about Fabric and how to customize it to your team’s preferences!