mvriel/Docblox — comment on commit 589ebad154ba881b6998425d81eaf677023a5b3c
File: docs/PSR.md line 514
By mvriel:

The examples that I encounter most (and coming from the Java world) is that no return results in an `@return void` tag. I think it to be explicit in telling the user that this function does not return anything.

Concerning `@return null` conceptually you do not return a value, that, when still caught, produces a null is a side-effect; not something which the user can rely on and a such shouldn't be documented as a fixed return value. (at least: that is how I perceive it)