DOC/Discussion: Update docstrings guide to include guidance for edge cases
There are a few edge cases where there is not sufficient guidance in the docstrings on how to proceed. For example, if a parameter argument takes a list of values but the list is sufficiently long, it is not clear how to properly format (see #28739).

Opening this as a placeholder to document edge cases encountered while cleaning up docstrings and agree on what the convention should be.