You can use this page to maintain the plain-text help that MDriven Designer shows for individual properties in the Property Inspector.
Purpose
MDriven Designer fetches this page to obtain additional information for properties displayed in the Property Inspector. The information helps a modeler understand a property while viewing or editing the selected model element.
This page is a data source for MDriven Designer. Write entries in the required key-and-value form so that Designer can identify the property and display its help text.
How property hints work
When you select an element in MDriven Designer, the Property Inspector shows the properties available for that element. If Designer finds a matching hint entry on this page, it can show the corresponding explanatory text.
For example, an entry whose key identifies a property named ExampleProperty provides the text that Designer can show for that property. The key is also visible in MDriven Designer, so choose a name that identifies the property clearly.
Authoring rules
Follow these rules for every property-hint entry:
| Rule | What to do |
|---|---|
| Key prefix | Start every key with #.
|
| Letter case | Keys are case-insensitive. |
| Key visibility | The key is shown in MDriven Designer. Use a clear, stable property identifier. |
| Hint text | Use plain text. Do not rely on wiki links, formatting, or other markup in the value; Designer does not render that markup correctly unless it has specific handling for it. |
Add or update a hint
- Identify the Property Inspector property that needs clarification.
- Create or locate its entry on this page.
- Ensure that the key starts with
#. - Write a short plain-text explanation that tells the modeler what the property affects and, where useful, what value to enter.
- Save the page.
- Open MDriven Designer and verify that the key and its text appear as expected for the relevant property.
Example structure
The following is an illustrative structure only. The key must match the property identifier that MDriven Designer expects.
#ExampleProperty
Explains what ExampleProperty controls and when you should set it.
Keep the displayed text focused on the property. For example, describe the effect of a setting rather than documenting an entire modeling workflow in the hint.
Write useful hint text
A good hint answers the question a modeler has at the moment they inspect the property:
- State what the property controls.
- State when the modeler should set it.
- Include an example value only when the valid value format is known.
- Keep the text short enough to be useful in the Property Inspector.
- Use terminology consistently with MDriven Designer.
Do not place wiki markup, internal links, or formatted examples in a hint value unless Designer is known to support that exact rendering. Plain text is the safe format.
Property hints and tagged-value hints
Property Inspector hints are not the same as tagged-value help. Use this page for information associated with properties shown in the Property Inspector. Maintain the list and usage guidance for tagged values in Documentation:MDrivenDesignerTaggedValueHints.
For how the tagged-value editor downloads and presents its help, see Documentation:Tagged values in the Designer.