Back to Home

Docs Best Practices

Docs seamlessly connect to your work, making it easy to plan, build, and ship new features.

  1. Docs Overview
  2. Use Cases
  3. Organization
  4. Quick Tips
  5. Transitioning to Docs

Step 3 - Organization

Learn how to keep your Docs organized so your Docs and your work live together seamlessly.

Linking Docs to Stories, Epics, Milestones, and Iterations

Shortcut makes it really easy to link Docs with Stories, Epics, Milestones, Iterations, and other Docs. When you want to find the PRD associated with an Epic, it’s linked to the Epic! When you want to find all the Stories associated with a PRD, they’re linked right in the Doc! 


A secondary way to organize your Docs is Collections. Collections are different from the traditional folder structure because they allow you to link Docs to multiple Collections. For example, I could add write a PRD about building a new Stories Backlog feature. That PRD could be added to the “PRD” Collection as well as the “Backlog” Collection. This makes it easier to find and does not bind you to a strict way of organizing. 

If you have any ideas on how you’d like to organize Docs within Shortcut, please let us know here. We are constantly evolving our feature set to better meet your organization’s needs.‍

Search, Following, and Recent

Select the Star at the top of any Doc to add it to your Followed Docs. This is a great place to keep the Docs you actively work on and you want to stay up to date on. Think of this as your personal folder or space to view the Docs you use the most. Following a Doc will add it to Following on the Doc menu and will send you an email notification when comments are made on the Doc.

Recent Docs
This is a great place to quickly jump back into a Doc you were recently working on. At a glance, it is easy to see the Doc Owner, the last time you viewed it, and more.

If your organization has a lot of Docs, search might be the fastest way to find the Doc you are looking for.