repaire help on View class document

[saeideng]

No description provided.

[dereuromark]

Wouldn't $this->viewBuilder()->theme('SuperHot'); suffice as one liner?
People could also place this somewhere else if they want to.

[saeideng]

oh , ok good idea

[ionas]

I do actually like the example. Gives you an idea where to place it.

[dereuromark]

@ionas But that should be in the docs (where it can be easily found with all the scope relevant things like namespace and use statements), not the doc block!

[ionas]

Agreed!

[ionas]

And it is. http://book.cakephp.org/3.0/en/views/themes.html#themes
Is there an option to add this to the class docblock as a link?

[markstory]

Examples should start with 3 backticks.

[markstory]

Short examples in the API are 👍. We have lots of examples already and more make the API a more useful resource in my opinion.

[dereuromark]

@markstory I think documentation can put those examples in better perspective. The API doc block can only do that much without getting out of hand. In this example one could easily add the theme() call inside beforeRender() as well as any other callback prior to that one - or even the action itself.
Thus IMO the doc block should be kept simple and "always true". But I don’t mind either way.