It would be nice to have a button that would parse php file and create missing documentation blocks automatically for class properties and methods. 

Also I would like to see documentation process little bit more smarter. For example currently such code by default is described as:

class myClass
{
    /**
     *
     * @var type 
     */
    public $var1 = 0;
    
    /**
     *
     * @var type 
     */
    public static $var2 = array();

    /**
     *
     * @param type $var
     * @return type 
     */
    public function myMethod($var = array())
    {
        return is_array($var) ? $var : false;
    }
}

What can be improved here is:
* Catching visibility, static or abstract declarations and including it to documentation. 
* Variables containing default value should be automatically recognised as correct datatype (boolean, integer, float, string or array) and values that does not have default property should be marked as "@param mixed". 
* Methods that does not return any value should be marked as "@return void".

So as result we could receive something like this:

class myClass
{
    /**
     * 
     * @access public
     * @var integer
     */
    public $var1 = 0;
    
    /**
     * @static
     * @access public
     * @var array
     */
    public static $var2 = array();

    /**
     * 
     * @access public
     * @param array $var
     * @return array|boolean 
     */
    public function myMethod($var = array())
    {
        return is_array($var) ? $var : false;
    }
    
    /**
     * 
     * @access public
     * @param mixed $name
     * @param mixed $value
     * @return void
     */
    public function __set($name, $value)
    {
        $this->$name = $value;
    }
}