Page History

...

Need to include information on using each control. How? What kind of information?

Purpose of the controls

In the knowledge transfer meeting between Dev and Services and at which Docu were in attendance, Philippe and Andreas clarified that the Form subapp  lists controls specifically for use in Magnolia 5 forms (dialogs) during app development, modification. All other Vaadin controls are for use within an app.

Vaadin approach

See: http://demo.vaadin.com/sampler Note that when the information is viewed this way, you get essentially what I would argue for in the Showcase app - a three column approach with headings that correspond to Control, Image, Description. The difference is that in Mag 5 we don't want to have click, jab to see the info.

...

1. Increase real estate for the fields (i.e make the light grey area bigger - stretch it to the left and right).
2. Only have two subapps -  Form Controls & Other Controls etc.
   
3. Add three columns - left to right:
   
   1. Control name tree similar to vaadin approach: http://demo.vaadin.com/sampler#
   2. Control. Shows a fully functional control.
   3. Appears when selected on left menu. Dynamic description box with links (changes to reflect control clicked on left menu.)
   Left align everything in each column.

...

If we are to add a link to Magnolia 5 that leads to our wiki or docu, the documentation requirements will need to be communicated clearly.