Restore flavor text to applications

Summary: D3581 removed some flavor text. Allow applications to provide flavor text instead of status information if they so desire.

Test Plan: {F20325}

Reviewers: vrana, btrahan

Reviewed By: btrahan

CC: aran, chad

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

src/applications/base/PhabricatorApplication.php

@@ -108,11 +108,33 @@ abstract class PhabricatorApplication {
 /* -(  UI Integration  )----------------------------------------------------- */
 
 
+  /**
+   * Render status elements (like "3 Waiting Reviews") for application list
+   * views. These provide a way to alert users to new or pending action items
+   * in applications.
+   *
+   * @param PhabricatorUser Viewing user.
+   * @return list<PhabricatorApplicationStatusView> Application status elements.
+   * @task ui
+   */
   public function loadStatus(PhabricatorUser $user) {
     return array();
   }
 
 
+  /**
+   * You can provide an optional piece of flavor text for the application. This
+   * is currently rendered in application launch views if the application has no
+   * status elements.
+   *
+   * @return string|null Flavor text.
+   * @task ui
+   */
+  public function getFlavorText() {
+    return null;
+  }
+
+
   /**
    * Build items for the main menu.
    *
@@ -120,7 +142,7 @@ abstract class PhabricatorApplication {
    * @param  AphrontController  The current controller. May be null for special
    *                            pages like 404, exception handlers, etc.
    * @return list<PhabricatorMainMenuIconView> List of menu items.
-   * @task UI
+   * @task ui
    */
   public function buildMainMenuItems(
     PhabricatorUser $user,