Homec4science

Reword daemon configuration issue in response to user issues

Authored by epriestley <git@epriestley.com> on Sep 5 2014, 21:27.

Description

Reword daemon configuration issue in response to user issues

Summary:
Ref T5968. Issues we've seen from users include:

  • Concern about severity ("... Need Restarting").
    • Reduce severity of explanatory text ("Different Config", "not severe").
    • Explain consequences in more detail.
    • In D10420, make "Ignore" easier to find.
    • Scope language for the multi-machine case ("at least one daemon").
  • Confusion about why daemons need restarting.
    • Unbury the lede ("Daemons and Web Have Different Config").
    • Make it clear that the root cause is a different checksum by showing the checksum. (This just hammers home that we're comparing checksums and this issue is about config checksums and we're not making it up, the checksums probably aren't that useful on their own.)
  • Difficulty understanding how to proceed when restarting does not resolve the issue:
    • Call out steps to take on the daemon console explicitly.
    • Walk through troubleshooting PHABRICATOR_ENV.
    • Walk through troubleshooting multiple local.json.

Test Plan: {F199245}

Reviewers: btrahan

Reviewed By: btrahan

Subscribers: epriestley

Maniphest Tasks: T5968

Differential Revision: https://secure.phabricator.com/D10421

Details

Committed
epriestley <git@epriestley.com>Sep 5 2014, 21:27
Pushed
aubortJan 31 2017, 17:16
Parents
rPH3958bf367767: Make it easier to ignore setup issues
Branches
Unknown
Tags
Unknown

Event Timeline

epriestley <git@epriestley.com> committed rPHaf842600ce79: Reword daemon configuration issue in response to user issues (authored by epriestley <git@epriestley.com>).Sep 5 2014, 21:27