[DOC] Add more canonical examples to the "Developing Documentation" page

[KishManani]

Describe the issue linked to the documentation

Raising this from this discussion.

I found that in the docs of the TimeSince transformer that the parameters were not being correctly rendered. I looked here to find out how I could remedy this. I found it difficult to understand where indents, spaces, and newlines were required. I initially looked at examples in the link to NumPy docstring format. However, I was looking for an example where there is a list in the parameters section and could not find this. @aiwalter kindly re-directed me to the Imputer documentation.

Suggest a potential alternative/fix

Add more canonical examples which cover a wider range of scenarios (e.g., a list of types in the parameters section).

[aiwalter]

I am wondering if Sphinx docs are covering this? Maybe we can just link it if there is sth..