Documentation should have at least one example, or show what is currently being used.

As BigDecimal with scale of more than 3 is truncated with , etc, as a workaround, we need to override the default display. I have been told that we should create this file:

views/_fields/bigDecimal/_displayWidget.gsp

The question is, what should go in this file? The documentation should have at least one example, or point to where the current contents of this file (which don't seem to exist).

I could do something like ${value}.toPlainString(), but what html formatting needs to go round it to make it look/work like the other values? E.g. does it need div or span? does it need any specific class defined? One example in the docs, or copies of the existing implementations (or link to them) would really help.

Start by locating the BigDecimal display documentation and existing field widget implementations, then compare them with the proposed views/_fields/bigDecimal/_displayWidget.gsp path. Document one working example or link to the current implementation, including the expected HTML formatting and CSS class usage. Done means a newcomer can determine what belongs in the override.

Written by the indexing model from the issue text.