Full or partial documentation?

Question

PHP

Is it necessary, in a good way, to document the obvious things:

/**
  * Order model.
  * 
  * @property Car $car
  */
class Order {

  /**
     *
     * Get the car record associated with the order. 
     *
     * @return \Illuminate\Database\Eloquent\Relations\HasOne
     */
    public function car()
    {
        return $this->hasOne('App\Models\Car');
    }

Or you can ignore:

/**
  * @property Car $car
  */
class Order {
  /*
     * @return \Illuminate\Database\Eloquent\Relations\HasOne
     */
    public function car()
    {
        return $this->hasOne('App\Models\Car');
    }

Answer 1

it makes sense to fill in if documentation is generated for these blocks later.
if the dockblock is purely for yourself, then you can omit it.

Answer 2

I would instead
// * Get the car record associated with the order.
the name of the function would be renamed to get_car or get_car_record

Answer 3

The main problem with annotations in weakly typed languages ​​is:
/**
* function which return dog
*/
getDog () {
return new Dog()
}
A year later:
/**
* function which return dog
*/
getDog () {
if ($this ->temperatureInZimbabve > 30 && $this->isHuman) {
$human = new Elepant()
$human->isLeopard = $this->getAnimalType(true, false)
return $human
}
return new Beer()
}