apache / apache/grails-core

Documentation Theming of f:table is unclear/missleading

Open
#14,257 1 comment 0 reactions 0 assignees View on GitHub
relates-to: grails-fields
Dominant language
Groovy
Stars
2.9k
Forks
975
Avg merge
1d 22h
Merged PRs (30d)
92

Description

According f:table documentation page (http://grails-fields-plugin.github.io/grails-fields/snapshot/ref/Tags/table.html), f:table tag accepts 'theme' attribute as other tags.žHowever, it is quite unclear where _table template should be stored(docs mentioning that "When theme is specified, the \_display template will be searched first in theme." which is quite unclear.
Also, I suppose that further clarification of how to use themes for _list templates is also needed.

Contributor guide

Open the contributing guide

Research direction

Start with the f:table documentation page linked in the issue and review its description of the theme attribute, _table templates, and _list templates. Clarify where themed templates are stored and add an example showing how themes apply to each template type; the documentation is done when these lookup paths and usage steps are explicit.

Written by the indexing model from the issue text.

Assessment

Tech stack
groovy
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.