docblock.php

<?php
/**
 * One line description of what this function or method does. This text usually appears inside an <h1> tag.
 *
 * Detailed description of what this function or method does. This text usually appears inside an <p> tag.
 *
 * @param <type> $firstParameter an explanation of what this parameter does
 * @param <type> $secondParameter an explanation of the second parameter
 * @return <type> what this function or method returns
 * @throws <type> what this function or method can throw, and why it will throw
 **/
function someFunction($firstParameter, $secondParameter) {
	// function goes here...
}