Enable RequireOneLinePropertyDocComment sniff

[Majkl578]

There is also counerpart sniff: DisallowOneLinePropertyDocComment.

I personally prefer the one-line variant, so starting with that one here.

ORM currently has lots of multilines for single undocumented @var.

[carusogabriel]

For now I'm 👎, but here's why: ORM/tests current has 100+ missing @var, and I think we should focus in add them, and maybe letter simplify :)

[alcaeus]

LGTM!

@carusogabriel since this will be in a new major version, ORM can either not upgrade or disable the new sniff until it’s appropriate to enable it and fix issues. That’s what we do in ODM to cope with the sheer number of checkstyles.

[Ocramius]

This sniff doesn't necessarily collide with having to add docblocks, so let's 🚢 :)

[Ocramius]

@Majkl578 is this still WIP?

[Majkl578]

If there are no objections, we can land this. I marked it as WIP & RFC since I expected discussion for require vs. disallow one-liners. 👍

[deeky666]

Isn't this a rule that should be applied to all doc comments? Why only on properties and not constants, methods, classes etc? Just wondering...

[Ocramius]

@deeky666 yes, but let's please RFC any additions please 😁