Some configuration operators correspond to multiple data operators, yet configuration operators contain references to specific data operators in their XML comments

[cjsha]

However, both of these docs have a problem which is that the Configuration node cannot say what data node to use because they are linked only through a device type. There could be different data nodes for the same configuration node. And with e.g. the TS4231xx stuff there are. So, this has nothing to do with the formatting of the boolean anymore but is a problem in both cases.

Originally posted by @jonnew in #198 (comment)

This seems to be a pattern repeated through the XML comments.

I see two options for resolving what Jon mentioned:

1. Remove those links in all configure<Whatever> operators
2. Remove those links in configure<Whatever> operators that can correspond to multiple <whatever>Data operators

[bparks13]

Is it too much effort to add links to the multiple different <whatever>Data nodes? That way people can still navigate to the correct one that they have, without having to manually search for it.

[cjsha]

Oh yeah. That's a valid 3rd option. I suspect that it's best to put that info somewhere in the docs repo instead of here though.

[jonnew]

Really what we want is something like this:

And the corresponding thing on the Configuration operators. Unfortunately, I think this would be difficult/inappropriate to din the XML comments so its something that's going to need to be manually curated or potentially automated on the docs site side.