Updated phpdocs

app/code/core/Mage/Adminhtml/Block/Api/User/Edit.php

@@ -42,12 +42,14 @@ public function __construct()
         ) . '\')) editForm.submit(\'' . $this->getUrl('*/*/delete') . '\'); return false;');
     }
 
+    /**
+     * @return string
+     */
     public function getHeaderText()
     {
         if (Mage::registry('api_user')->getId()) {
             return Mage::helper('adminhtml')->__("Edit User '%s'", $this->escapeHtml(Mage::registry('api_user')->getUsername()));
-        } else {
-            return Mage::helper('adminhtml')->__('New User');
         }
+        return Mage::helper('adminhtml')->__('New User');
     }
 }

app/code/core/Mage/Adminhtml/Block/Catalog/Product/Attribute/Edit.php

@@ -68,6 +68,9 @@ public function __construct()
         }
     }
 
+    /**
+     * @return string
+     */
     public function getHeaderText()
     {
         if (Mage::registry('entity_attribute')->getId()) {
@@ -76,16 +79,21 @@ public function getHeaderText()
                 $frontendLabel = $frontendLabel[0];
             }
             return Mage::helper('catalog')->__('Edit Product Attribute "%s"', $this->escapeHtml($frontendLabel));
-        } else {
-            return Mage::helper('catalog')->__('New Product Attribute');
         }
+        return Mage::helper('catalog')->__('New Product Attribute');
     }
 
+    /**
+     * @return string
+     */
     public function getValidationUrl()
     {
         return $this->getUrl('*/*/validate', ['_current' => true]);
     }
 
+    /**
+     * @return string
+     */
     public function getSaveUrl()
     {
         return $this->getUrl('*/' . $this->_controller . '/save', ['_current' => true, 'back' => null]);

app/code/core/Mage/Adminhtml/Block/Catalog/Search/Edit.php

@@ -38,12 +38,14 @@ public function __construct()
         $this->_updateButton('delete', 'label', Mage::helper('catalog')->__('Delete Search'));
     }
 
+    /**
+     * @return string
+     */
     public function getHeaderText()
     {
         if (Mage::registry('current_catalog_search')->getId()) {
             return Mage::helper('catalog')->__("Edit Search '%s'", $this->escapeHtml(Mage::registry('current_catalog_search')->getQueryText()));
-        } else {
-            return Mage::helper('catalog')->__('New Search');
         }
+        return Mage::helper('catalog')->__('New Search');
     }
 }

app/code/core/Mage/Adminhtml/Block/Checkout/Agreement/Edit.php

@@ -45,8 +45,7 @@ public function getHeaderText()
     {
         if (Mage::registry('checkout_agreement')->getId()) {
             return Mage::helper('checkout')->__('Edit Terms and Conditions');
-        } else {
-            return Mage::helper('checkout')->__('New Terms and Conditions');
         }
+        return Mage::helper('checkout')->__('New Terms and Conditions');
     }
 }

app/code/core/Mage/Adminhtml/Block/Cms/Block/Edit.php

@@ -68,8 +68,7 @@ public function getHeaderText()
     {
         if (Mage::registry('cms_block')->getId()) {
             return Mage::helper('cms')->__("Edit Block '%s'", $this->escapeHtml(Mage::registry('cms_block')->getTitle()));
-        } else {
-            return Mage::helper('cms')->__('New Block');
         }
+        return Mage::helper('cms')->__('New Block');
     }
 }

app/code/core/Mage/Adminhtml/Block/Cms/Page/Edit.php

@@ -65,9 +65,8 @@ public function getHeaderText()
     {
         if (Mage::registry('cms_page')->getId()) {
             return Mage::helper('cms')->__("Edit Page '%s'", $this->escapeHtml(Mage::registry('cms_page')->getTitle()));
-        } else {
-            return Mage::helper('cms')->__('New Page');
         }
+        return Mage::helper('cms')->__('New Page');
     }
 
     /**
@@ -97,9 +96,7 @@ protected function _getSaveAndContinueUrl()
     }
 
     /**
-     * Prepare layout
-     *
-     * @return Mage_Core_Block_Abstract
+     * @inheritDoc
      */
     protected function _prepareLayout()
     {

app/code/core/Mage/Adminhtml/Block/Customer/Edit.php

@@ -58,6 +58,9 @@ public function __construct()
         }
     }
 
+    /**
+     * @return string
+     */
     public function getCreateOrderUrl()
     {
         return $this->getUrl('*/sales_order_create/start', ['customer_id' => $this->getCustomerId()]);
@@ -68,13 +71,15 @@ public function getCustomerId()
         return Mage::registry('current_customer')->getId();
     }
 
+    /**
+     * @return string
+     */
     public function getHeaderText()
     {
         if (Mage::registry('current_customer')->getId()) {
             return $this->escapeHtml(Mage::registry('current_customer')->getName());
-        } else {
-            return Mage::helper('customer')->__('New Customer');
         }
+        return Mage::helper('customer')->__('New Customer');
     }
 
     /**
@@ -89,11 +94,17 @@ public function getFormHtml()
         return $html;
     }
 
+    /**
+     * @return string
+     */
     public function getValidationUrl()
     {
         return $this->getUrl('*/*/validate', ['_current' => true]);
     }
 
+    /**
+     * @inheritDoc
+     */
     protected function _prepareLayout()
     {
         if (!Mage::registry('current_customer')->isReadonly()) {
@@ -107,6 +118,9 @@ protected function _prepareLayout()
         return parent::_prepareLayout();
     }
 
+    /**
+     * @return string
+     */
     protected function _getSaveAndContinueUrl()
     {
         return $this->getUrl('*/*/save', [

app/code/core/Mage/Adminhtml/Block/Customer/Group/Edit.php

@@ -43,6 +43,10 @@ public function __construct()
         }
     }
 
+    /**
+     * @return string
+     * @throws Exception
+     */
     public function getDeleteUrl()
     {
         if (!Mage::getSingleton('adminhtml/url')->useSecretKey()) {
@@ -55,15 +59,20 @@ public function getDeleteUrl()
         }
     }
 
+    /**
+     * @return string
+     */
     public function getHeaderText()
     {
         if (!is_null(Mage::registry('current_group')->getId())) {
             return Mage::helper('customer')->__('Edit Customer Group "%s"', $this->escapeHtml(Mage::registry('current_group')->getCustomerGroupCode()));
-        } else {
-            return Mage::helper('customer')->__('New Customer Group');
         }
+        return Mage::helper('customer')->__('New Customer Group');
     }
 
+    /**
+     * @return string
+     */
     public function getHeaderCssClass()
     {
         return 'icon-head head-customer-groups';

app/code/core/Mage/Adminhtml/Block/Newsletter/Template.php

@@ -34,17 +34,26 @@ public function __construct()
         $this->setTemplate('newsletter/template/list.phtml');
     }
 
+    /**
+     * @inheritDoc
+     */
     protected function _prepareLayout()
     {
         $this->setChild('grid', $this->getLayout()->createBlock('adminhtml/newsletter_template_grid', 'newsletter.template.grid'));
         return parent::_prepareLayout();
     }
 
+    /**
+     * @return string
+     */
     public function getCreateUrl()
     {
         return $this->getUrl('*/*/new');
     }
 
+    /**
+     * @return string
+     */
     public function getHeaderText()
     {
         return Mage::helper('newsletter')->__('Newsletter Templates');

app/code/core/Mage/Adminhtml/Block/Newsletter/Template/Edit.php

@@ -46,9 +46,7 @@ public function getModel()
     }
 
     /**
-     * Preparing block layout
-     *
-     * @return $this
+     * @inheritDoc
      */
     protected function _prepareLayout()
     {
@@ -254,7 +252,6 @@ public function getHeaderText()
         if ($this->getEditMode()) {
             return Mage::helper('newsletter')->__('Edit Newsletter Template');
         }
-
         return  Mage::helper('newsletter')->__('New Newsletter Template');
     }
 

app/code/core/Mage/Adminhtml/Block/Permissions/Block/Edit.php

@@ -47,8 +47,7 @@ public function getHeaderText()
     {
         if (Mage::registry('permissions_block')->getId()) {
             return Mage::helper('adminhtml')->__("Edit Block '%s'", $this->escapeHtml(Mage::registry('permissions_block')->getBlockName()));
-        } else {
-            return Mage::helper('adminhtml')->__('New block');
         }
+        return Mage::helper('adminhtml')->__('New block');
     }
 }

app/code/core/Mage/Adminhtml/Block/Permissions/User/Edit.php

@@ -42,12 +42,14 @@ public function __construct()
         ) . '\')) editForm.submit(\'' . $this->getUrl('*/*/delete') . '\'); return false;');
     }
 
+    /**
+     * @return string
+     */
     public function getHeaderText()
     {
         if (Mage::registry('permissions_user')->getId()) {
             return Mage::helper('adminhtml')->__("Edit User '%s'", $this->escapeHtml(Mage::registry('permissions_user')->getUsername()));
-        } else {
-            return Mage::helper('adminhtml')->__('New User');
         }
+        return Mage::helper('adminhtml')->__('New User');
     }
 }

app/code/core/Mage/Adminhtml/Block/Permissions/Variable/Edit.php

@@ -45,8 +45,7 @@ public function getHeaderText()
     {
         if (Mage::registry('permissions_variable')->getId()) {
             return Mage::helper('adminhtml')->__("Edit Variable '%s'", $this->escapeHtml(Mage::registry('permissions_variable')->getVariableName()));
-        } else {
-            return Mage::helper('adminhtml')->__('New Variable');
         }
+        return Mage::helper('adminhtml')->__('New Variable');
     }
 }

app/code/core/Mage/Adminhtml/Block/Poll/Answer/Edit.php

@@ -46,6 +46,9 @@ public function __construct()
         $this->_updateButton('delete', 'label', Mage::helper('poll')->__('Delete Answer'));
     }
 
+    /**
+     * @return string
+     */
     public function getHeaderText()
     {
         return Mage::helper('poll')->__("Edit Answer '%s'", $this->escapeHtml(Mage::registry('answer_data')->getAnswerTitle()));

app/code/core/Mage/Adminhtml/Block/Poll/Edit.php

@@ -41,12 +41,14 @@ public function __construct()
         $this->setValidationUrl($this->getUrl('*/*/validate', ['id' => $this->getRequest()->getParam($this->_objectId)]));
     }
 
+    /**
+     * @return string
+     */
     public function getHeaderText()
     {
         if (Mage::registry('poll_data') && Mage::registry('poll_data')->getId()) {
             return Mage::helper('poll')->__("Edit Poll '%s'", $this->escapeHtml(Mage::registry('poll_data')->getPollTitle()));
-        } else {
-            return Mage::helper('poll')->__('New Poll');
         }
+        return Mage::helper('poll')->__('New Poll');
     }
 }

app/code/core/Mage/Adminhtml/Block/Promo/Catalog/Edit.php

@@ -64,8 +64,7 @@ public function getHeaderText()
         $rule = Mage::registry('current_promo_catalog_rule');
         if ($rule->getRuleId()) {
             return Mage::helper('catalogrule')->__("Edit Rule '%s'", $this->escapeHtml($rule->getName()));
-        } else {
-            return Mage::helper('catalogrule')->__('New Rule');
         }
+        return Mage::helper('catalogrule')->__('New Rule');
     }
 }

app/code/core/Mage/Adminhtml/Block/Promo/Quote/Edit.php

@@ -57,9 +57,8 @@ public function getHeaderText()
         $rule = Mage::registry('current_promo_quote_rule');
         if ($rule->getRuleId()) {
             return Mage::helper('salesrule')->__("Edit Rule '%s'", $this->escapeHtml($rule->getName()));
-        } else {
-            return Mage::helper('salesrule')->__('New Rule');
         }
+        return Mage::helper('salesrule')->__('New Rule');
     }
 
     /**

app/code/core/Mage/Adminhtml/Block/Rating/Edit.php

@@ -45,12 +45,14 @@ public function __construct()
         }
     }
 
+    /**
+     * @return string
+     */
     public function getHeaderText()
     {
         if (Mage::registry('rating_data') && Mage::registry('rating_data')->getId()) {
             return Mage::helper('rating')->__("Edit Rating", $this->escapeHtml(Mage::registry('rating_data')->getRatingCode()));
-        } else {
-            return Mage::helper('rating')->__('New Rating');
         }
+        return Mage::helper('rating')->__('New Rating');
     }
 }

app/code/core/Mage/Adminhtml/Block/Review/Add.php

@@ -110,6 +110,9 @@ public function __construct()
         ';
     }
 
+    /**
+     * @return string
+     */
     public function getHeaderText()
     {
         return Mage::helper('review')->__('Add New Review');

app/code/core/Mage/Adminhtml/Block/Review/Edit.php

@@ -119,12 +119,14 @@ public function __construct()
         ';
     }
 
+    /**
+     * @return string
+     */
     public function getHeaderText()
     {
         if (Mage::registry('review_data') && Mage::registry('review_data')->getId()) {
             return Mage::helper('review')->__("Edit Review '%s'", $this->escapeHtml(Mage::registry('review_data')->getTitle()));
-        } else {
-            return Mage::helper('review')->__('New Review');
         }
+        return Mage::helper('review')->__('New Review');
     }
 }

app/code/core/Mage/Adminhtml/Block/Sales/Order/Create/Billing/Method.php

@@ -33,11 +33,17 @@ public function __construct()
         $this->setId('sales_order_create_billing_method');
     }
 
+    /**
+     * @return string
+     */
     public function getHeaderText()
     {
         return Mage::helper('sales')->__('Payment Method');
     }
 
+    /**
+     * @return string
+     */
     public function getHeaderCssClass()
     {
         return 'head-payment-method';