You can configure a dashboard that is displayed by default to guest users. This dashboard can provide an overview of your projects to visitors, customers, and external users.
If you don't configure the default dashboard, all your visitors see is this:
Surely, you can do better.
Take a look at the default dashboard that we built for the JetBrains YouTrack instance.
Guest users can see all of the following information at a glance:
- The top issue reporters in the IntelliJ IDEA, CLion and AppCode projects.
- The distribution of issues in our major projects.
- The number of new and resolved issues for our team tools.
- A list of issues that are currently in progress.
The best part is that all of these widgets are interactive. The projects that are shown on the dashboard are visible to guest users. This means that visitors can click through and view the public details of issues, code reviews, and commits that are shown in the report widgets.
This guide shows you what you can do to pretty up this page.
Step 1 — Collect your Content
The first step is to curate content that you think would be interesting to visitors and guests. Think about your dashboard as if it were an art gallery. Carefully consider which pieces you want to put on display. When in doubt, collect more than you need. You can set up a permanent collection and a rotating exhibition.
If guest users can report issues in YouTrack, generate a pre-configured issue template URL and insert it in a notes widget.
You can use wiki markup to format your text any way you want, add images, and insert links to other resources.
Use issue widgets to display lists of issues that match specific filter criteria. Here are few possibilities:
- Display a list of issues with the
reported by: mesearch query. This type of list is especially useful when you have a dedicated project to collect feedback. Guest users see a list of issues that they have reported themselves and issues that were reported by other guests.
- List the issues that are currently in progress for your projects.
- Feature a list of issues that were resolved during the week.
Step 2 — Round Up Reports
You can only add YouTrack report widgets for existing reports to your dashboard.
Talk to your project teams and find out if they already have any reports that would be interesting for visitors. When you see a report you like, you can either ask the owner to share it or create a clone for you to use on the dashboard.
Step 3 — Deck Out your Dashboard
Once you've assembled all of your content, you're ready to build your dashboard.
To configure the default dashboard:
- Click the Dashboard link in the header.
- From the dashboard list, select Default.
- Click the Add widget button and select the type of widget that you want to display.
- Configure the widget settings and click the Create widget button to save the widget to the dashboard.
- Repeat steps 3 and 4 until you have added all of your content.
- Organize the content.
Step 4 — Roll Out the Red Carpet
When your dashboard is ready, spread the word! Add links to the dashboard to your website and marketing campaigns. Tweet about it. Invite visitors to learn more about your products and encourage customers to participate in your development process.
The dashboard is a great tool for engaging with the public and broadcasting your efforts. Your team works hard — it's OK to show off a little.