...

1. The information should be succinct, descriptive but not contain any coding information or any detail beyond a brief usage description for each item.
2. For further information the user needs to look to official documentation. For this reason there needs to be a link to official documentation from within Magnolia CMS 5. (Note that this solution assumes that extra information is required. It may not be.)

Currently there are three tabs in the showcase app:

...

All three tabs require changes. To summarize - make it more :

• Make each tab tabular. Classic table with header, columns and rows (albeit these are invisible). Keep things nicely spaced.
• General suggestion valid for all three tabs is to add a link to official documentation, where users can find detailed information on using fields. The link could be by the line "Showcase apps......." above the tabs. Or, link to a more specific page from each tab. See Mockup proposal.

Question for going forward - Is the showcase app like to expand? As in, how likely is it that over time more and more fields will be added. If this is the case, then it might be worth considering adding Categories for the Form Field tab control list. For example Text, Button etc. The question then is whether to list by control type ('Text fields')  or functional type (Text inputs) which include ('Text fields'). Vaadin mix these and I think that is a sensible approach.

Examples:

Form fields tab changes

Suggest making a few alterations to the Showcase App: Form fields tab:

...