User:Johnuniq/Convert documentation

Users of convert as implemented by Module:Convert should see Help:Convert for documentation. In addition, the template's documentation page will be updated with a how-to overview.

This page provides some extra notes.

Deployment
After convert is switched to use Module:Convert, some issues will need to be fixed.

Error messages
The following categories should be monitored to check for problems.
 * Category:Convert invalid units
 * Category:Convert invalid options

Spell
The old templates use convert/spell to spell numbers as words. The module works differently, and has the limitation that only the input number can be spelled.

Use the following steps to change the wikitext for  to use the module:
 * Change " " to "in" (or "In" if uppercase is specified).
 * Omit l.
 * Omit on. When using spell, the old templates ignore this option, and that is probably what is wanted. However, the module will use symbols if on is used. This option should probably be removed so that the full name of the unit is shown.

Some examples follow.

Conversions that do not specify an output unit may give different results because the module uses the normal rules for determining the default output regardless of whether spelling is enabled, whereas the old templates sometimes use different defaults. For example, the input unit  (inches) normally uses   as the default output, but uses   with.

Options
In addition to the options listed at Help:Convert, the following are defined.

The  and   options are experiments to produce a more logical alternative syntax with more comprehensible wikitext.

Option  may be useful at other Wikipedias. For example, from the Bengali Wikipedia:
 * → ১,২৩৪ মিটার (৪,০৪৯ ফু)
 * → 1,234 মিটার (4,049 ফু)