Weird formatting of events list from evented class docs

[jni]

See e.g. layerlist:
https://napari.org/0.5.0/api/napari.components.LayerList.html#napari.components.LayerList

Note the double parentheses:

And the eventedlist:
https://napari.org/0.5.0/api/napari.utils.events.EventedList.html#napari.utils.events.EventedList

Now the parentheses are moved and the first word is in bold:

I haven't yet investigated whether this is a bug in the theme or the docs though.

[melissawm]

OK I had a look at this, and this is basically a limitation of Napoleon and how it handles these custom sections. There are three ways of presenting the custom sections: general, params_style and returns_style. We have been using params_style (returns_style would be the same) and this style expects parameters to be defined as

param : type
     Long description

It will automatically create the parenthesis around the type for each parameter, which is what we observe. But then, for the custom Events section, we are manually adding parenthesis to each event type:

https://github.com/napari/napari/blob/bed967f81fcef2b86bd83d5c1b741d98cc2d91fe/napari/utils/events/containers/_evented_list.py#L66

That's why we get double parenthesis.

We can either remove the manual parenthesis from the docstrings (although that may make it weird, too):

Or we can change the custom section to be a "general" section, which will show similar to Methods and Attributes:

In any case, this is not a theme issue so I'll move it over to napari/docs.