Skip to content
Source
Sign inSign up

Run the roadmap

Teams and community / Community

Run the roadmap

People ask you for features and ask what comes next, and you want one public place that shows your plan. The Roadmap part of the Community tab is that place, and an accepted feature request goes on it in one click.

3 min read

When you ship an idea, the person who had it gets credit on their profile.

You need write access to the repository for every step on this page.

1. Accept an idea

  1. Open the repository, then Community. Feature requests opens first.
  2. Open a request. Top shows the requests with the most votes first.
  3. Under Maintainer actions, click Accept and add to roadmap.
An accepted feature request, with the note that it is on the roadmap and the Maintainer actions on the right

The request gets the state Accepted. A new roadmap entry with its title goes to the end of Next. The entry has a Community idea badge with the avatar of the author, and it links to the request. To add a description, use Edit in the menu of the entry (step 4).

2. Say no, or merge two requests

Use these on an open request, under Maintainer actions:

  • Decline: type a Reason, then click Decline request. Everyone who reads the request sees your reason.
  • Mark as duplicate: type the Number of the other request, then click Mark as duplicate. The votes go to the other request, and this one closes.

3. Add your own entries

Not every plan comes from a request.

  1. Open Community, then Roadmap.
  2. Click Add entry.
  3. Type a Title and a Description. Pick a Column.
  4. If you have a target month, type it in Target month (YYYY-MM). You can leave it empty.
  5. Click Add entry.

Now, Next and Later hold at most 200 entries each. Shipped has no limit.

4. Move entries as the work goes on

The columns are Now, Next, Later and Shipped.

  1. Click the menu (three dots) on an entry.
  2. Under Move to, pick a column. Use Move up and Move down to change the order in a column.
  3. To change the text or the month, click Edit. To remove the entry, click Delete.

When you delete an entry that came from a request, the request goes back to Open.

5. Ship it

When the work is done, open the menu of the entry. Under Move to, pick Shipped.

The roadmap with an entry in Now that has a target month, and a shipped entry with a Community idea badge and its ship date

The entry shows the ship date. If it came from a request:

  • The request gets the state Shipped.
  • The idea shows on the Ideas tab of its author's profile, if the repository is public.

If you move the entry out of Shipped, the request is Accepted again, and the idea leaves the profile.

Who sees it

  • Everyone who can read the repository sees the roadmap.
  • Only people with write access change it, on the web. Agents and tokens can only read it.
  • The repository home page shows the entries in Now.

Done

Your plan is public, in four columns. Accepted ideas are on it with credit to the people who had them. When you ship one, its author sees it on their profile.