docblocks.php

<?php

class OptionA
{
    /**
     * @var \DateTime $date
     */
    private $date;
    // the $date in the docblock seems redundant?
}

class OptionB
{
    /**
     * @var \DateTime
     */
    private $date;
    // 
}

class OptionC
{
    /**
     * @var \DateTime The date of creation
     */
    private $date;
    // 
}

@adrienbrault cheers. That probably works for properties that can be described briefly. What if you need to describe a property with more than one sentence? E.g.

<?php

class OptionD
{
    /**
     * The date of creation.
     * 
     * This will never be a date less than 1970.
     *
     * @var \DateTime 
     */
    private $date;
}

class OptionE
{
    /**
     * This will never be a date less than 1970.
     *
     * @var \DateTime The date of creation
     */
    private $date;
}