Page MenuHomePhabricator

UX for new administrators on fresh installs
Closed, DuplicatePublic

Description

When we replace home with dashboards, we'll no longer have a default home page to show administrators when they first login during setup.

On the balance, I think this is probably good thing, since the current default home page is not very useful, especially on a fresh install.

Two possible approaches:

  1. Just automatically build a "reasonable" default dashboard and install it on startup.
  2. Or, do something more onboarding/setup-focused.

(1) is straightforward, but a bit messy technically (for example, we're rarely going to test it -- especially if it's only on the install workflow -- and it's hard to unit test, and it's generally worse to break something on setup/install than elsewhere). It also won't be a very good first experience (everything will be empty) and it will have all the issues the current homepage does (being an OK fit for a lot of users, but a good fit for very few).

I'd like to experiment with (2), and build something that provides a more structured setup workflow for administrators, and guides them through setup tasks. Particularly:

  • Set up authentication (there's a small hint about this in setup issues, but it could be expanded on);
  • configure settings (there are almost no pointers to this);
  • install/uninstall/pin applications;
  • build a dashboard to replace this workflow.

And then maybe some general links to "learn more about tasks", "learn more about code review", etc.

Generally, I think we've had good luck with the "X unresolved setup issues" workflow, and want to try expanding that into onboarding -- the idea being "Quest Tracker" (optional, asynchronous, random-access, non-modal), not "Wizard" (sequential, mandatory, modal).

I think we'll also need/want some degree of dashboard templating or prefabrication, but can build that in a more tailored, testable workflow.

Revisions and Commits

Restricted Differential Revision
Restricted Differential Revision

Event Timeline

epriestley raised the priority of this task from to Normal.
epriestley updated the task description. (Show Details)
epriestley added a project: Dashboards.

Here's roughly where I'm headed with this, so far:

Screen_Shot_2014-06-17_at_10.37.31_AM.png (1×1 px, 305 KB)

I need to fix header colors.

What's next here? This seems like a good one to get done close to the Phacility launch and / or iterate on soon after?

I think we can remove Support Impact from this. I've seen fewer setup/install-realted issues recently, and imagine this is going to be a long-tail task with a lot of ongoing tweaks that probably should happen post-Phacility.

I think the blockers here are:

  • Dashboards need to be in good shape because the exit from the "Quest Tracker" is to replace it with a dashboard. They have a few stragglers kicking around like some policy stuff, and I think the templates / first-time-user workflow could be better.
  • The actual quest tracker thing could probably use a bit more work and polish. I think it's mostly OK, but still looks kind of complex and overwhelming to me.

I'd probably look at making "Admin Quest Tracker" and "Setup Issues" a Dashboard Panel for Admins... somehow.

chad raised the priority of this task from Normal to High.
epriestley edited projects, added Dashboards (v2); removed Dashboards.

parrot

im gonna do this task. im gonna do it up real nice.

Merging over into newer task.