[Freeipa-users] Commands ipa topologysegment-find/show are confusing

[Jesús Marín García]

Hello everyone:

These days I have been doing a freeipa upgrade on a production cluster,
what requires to perform multiple operations on the cluster for doing it
without service interruption.
One of the tasks was to ensure the topology is a complete graph, where each
node have a connection with all the other nodes.

In order to get the current topology, the command is `ipa
topologysegment-find ca/domain`
But this is confusing since there is another command named `ipa
topologysegment-show...`.

A user could expect the following behaviour:
- topologysegment-show -> List all the elements, since "show" means you
want to see something in general terms.
- topologysegment-find -> List filtered elements by a given value, since
"find" means you want to see something concrete.

This is the same with other topics of the IPA command.

I think this sould be changed in order to be more clear. My proposal is as
follows:

- "topic"-list -> in order to list all the elements.
- "topic"-find -> in order to get certain elements filtered  by a given
value.
- "topic"-detail or "topic"-describe -> in order to see the details
of a
given element.

What do you think? Do you also find current commands confusing?

Thanks,
Regards