Best practices for using expanding, toggle or dropdown?

[Tova Cohen]

Are there any best practices or recommendations for when to use expanding text vs. toggles vs. dropdown text?
I am very new to Flare. I've been unable to find any information about why you would choose one over the other.
Experimenting with all 3 appears to indicate:

- Use toggles when the hot spot and the target text are not adjacent.
- Use expanding text when the hotspot and the text are in a single element.
- Use dropdown text when the hotspot is in one element and the text is in one or more following elements.

However, I see in Flare user doc that expanding text does support multiple elements. Only I can't figure out how to implement that.

Can anyone provide any guidance on when to use which formatting style?
I need to pick one way to represent a list of parameters. Each parameter name has the code character format and might also have an argument that is a variable. I want the parameter name to be the hotspot that you click to display its description. The parameter descriptions range from one short sentence to multiple paragraphs that contain various character styles and paragraph styles such as lists.

Thanks!
Tova

[kwag_myers]

I've only used Drop-Down and Expanding Text, which are both described in the Navigation and Link section of Flare's Help.

Drop-Down is for larger portions of the topic. In fact, I have whole topics that are drop-downs (Product Manager's idea, not mine). Expanding is for a single paragraph. Both are used in the topic About Links, where there's a triangle icon denoting drop-downs and "Read more..." links for expanding text.

The CSS styles for each are under Madcap, e.g., Madcap|Expanding.