Close #8573: napoleon: Add more custom section styles

[SolidifiedRay]

Subject: add more custom section styles

Feature or Bugfix

• Feature

Purpose

napoleon_custom_sections option does not allow to configure the style, and the default style is inconsistent with the rest of the doc. It will be nice if we can choose between a few more styles. This new feature add two more styles that can make the custom section more consistent with the Parameter section or the Return section.
Behavior:
napoleon_custom_sections = [('Custom Section', 'params_style')]
or
napoleon_custom_sections = [('Custom Section', 'returns_style')]

Detail

• The default style is inconsistent
  

• Display like the parameter section
  

• Display like the return section
  

Relates

• Others people have expressed a similar desire (see Custom docstring section sphinx-contrib/napoleon#2)
• refs: Napoleon: more custom docstring section styles #8573

[tk0miya]

Could you add testcases for new behavior?

[SolidifiedRay]

Hi @tk0miya, I have added the tests, changed the name, and updated the doc. Thank you for the review!

[tk0miya]

LGTM with nits!

[SolidifiedRay]

I have fixed the nits, but the CircleCI tests failed after the changes. I only edited some lines inside napoleon.rst, and the error message seems irrelevant to my code. Could you help me have a look at it? Thanks! @tk0miya

[tk0miya]

Merged. Thank you for your contribution!

Note: I manually re-ran the testcase and confirmed all tests passed.