[jira] Created: (TAPESTRY-2583) Documentation on Block component needs warning text

["Albert Tumanov (JIRA)" <de...@tapestry.apache.org>]

Documentation on Block component needs warning text
---------------------------------------------------

                 Key: TAPESTRY-2583
                 URL: https://issues.apache.org/jira/browse/TAPESTRY-2583
             Project: Tapestry
          Issue Type: Improvement
          Components: Documentation
    Affects Versions: 4.1.5
            Reporter: Albert Tumanov


The documentation page

http://tapestry.apache.org/tapestry4.1/components/general/block.html

says "When a Block  component renders normally, it does absolutely nothing."

It is not quite correct, because the pageBeginRender() method of the Block will always be executed
(even if the Block is never rendered).
And the method usually contains some expensive database calls that would better be avoided.

I propose to add a warning text into the documentation, like this:

"NB: the pageBeginRender() method of the Block will always be executed (even if the Block is never rendered)"

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tapestry.apache.org
For additional commands, e-mail: dev-help@tapestry.apache.org