Hmm, I agree we can highlight this better. But it's also true ofrender, not onlyrender_esi. Also, I think the standards aremaxPerPage and the controller name should becontentAction (since most people are probably using the normal shortcut syntax for the controller.

Wedo show the$max variable being passed as an argument in the next example. Perhaps we just need to add a note about that. For example:

..tip::    Any extra variables you pass (like ``max`` in the above example) will become arguments    to your controller (e.g. ``$max``). You can see this in the controller below.

What do you think?

I agree, but I think we need to be explicit with the named part. Those variables were just made up to be honest, Easy to change :)

@Farkie You want to be explicit with the named part? So what do you mean/propose exactly? Sorry, I don't understand - I think you agree with changing the variable names but I'm not sure what you think about my other points :). Can you make the changes you think make sense? That might help.

Thanks!