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

I vote to retain 'void' as keyword for saying: no return value is defined. To me this is very explicit in meaning whereas if you were to use null as well for this purpose I think its meaning becomes ambiguous as @ashnazg tried to illustrate.

Concerning constructors I think we should add a clause that the @return tag MAY be omitted and if omitted MUST be interpreted as if it were 'self'.
In my opinion this description could best be added in the @return tag description.