diff --git a/developer/hooks/core.php b/developer/hooks/core.php
index 4901c5f..9490a3f 100755
--- a/developer/hooks/core.php
+++ b/developer/hooks/core.php
@@ -729,8 +729,13 @@ function hook_schema_alter(&$schema) {
  * One popular use of this hook is to add form elements to the node form. When
  * altering a node form, the node object retrieved at from $form['#node'].
  *
- * Note that instead of hook_form_alter(), which is called for all forms, you
- * can also use hook_form_FORM_ID_alter() to alter a specific form.
+ * There are two methods of altering forms:
+ * - hook_form_FORM_ID_alter() is called first and is specific to a single form.
+ * - hook_form_alter() is called for all forms after the specific changes have
+ *   been made.
+ * Note that since hook_form_FORM_ID_alter() is called first, changes made by
+ * hook_form_alter() will not be available to it. Because of this most modules
+ * use hook_form_alter().
  *
  * @param $form
  *   Nested array of form elements that comprise the form. The arguments
@@ -741,6 +746,8 @@ function hook_schema_alter(&$schema) {
  * @param $form_id
  *   String representing the name of the form itself. Typically this is the
  *   name of the function that generated the form.
+ *
+ * @see hook_form_FORM_ID_alter()
  */
 function hook_form_alter(&$form, &$form_state, $form_id) {
   if (isset($form['type']) && isset($form['#node']) && $form['type']['#value'] .'_node_form' == $form_id) {