Not all default included template tags are documented in the "Template tags and extensions reference"

[AMcBain]

About 90% of all template tags included with Play! itself are documented in the "Template tags and extensions reference" documentation reference. Some are not, such as ifError, ifErrors, etc. I can get that they're somewhat documented elsewhere (such as the validation section for ifErrors), but they should have even a small description in this list and possibly a link then to where they're explained in more detail elsewhere.

Personally, I go to that page because I know it has a long list of a lot of the tags available. It's not great to have to dig around to find others not listed there, or for some not documented at all (ifError for example) to visit the source for Play! ...

[Peter Hilton (pedro-lunatech)]

Guillaume, you wrote somewhere that some of the tags are not documented, because you do not like their implementation and expect them to change. Given that people seem to be using these tags anyway, does it make sense to just document all of them, perhaps marking some as 'likely to change in Play 1.1'?

[Guillaume Bort (guillaume-bort)]

Yes perhaps.

On Tue, Jul 27, 2010 at 11:15 AM, Peter Hilton
<email address hidden> wrote:
> Guillaume, you wrote somewhere that some of the tags are not documented,
> because you do not like their implementation and expect them to change.
> Given that people seem to be using these tags anyway, does it make sense
> to just document all of them, perhaps marking some as 'likely to change
> in Play 1.1'?
>
> ** Changed in: play
>     Assignee: (unassigned) => Guillaume Bort (guillaume-bort)
>
> --
> Not all default included template tags are documented in the "Template tags and extensions reference"
> https://bugs.launchpad.net/bugs/603418
> You received this bug notification because you are a bug assignee.
>

--
Guillaume Bort, http://guillaume.bort.fr

For anything work-related, use <email address hidden>; for everything else,
write <email address hidden>