A proper goddamn comment

gistfile1.php

/**
 * Short description.
 *
 * A longer, multi-line description.
 *
 * @param string $name 
 *   A description of your variable
 * @param int $count (default: 0)
 *
 * @return boolean
 *   What you expect to return.
 */
function function_name($name, $count = 0) {
  // Stuff
  
  return TRUE;
}