Two docstring style guides

[moorepants]

There seems to be two docstring style guides in the dev documentation:

First:

Second:

[Abhishekjsr283204]

@moorepants Good evening sir should we remove the one in the docstring style guide or anything else please clear more specifically this issue. how to tackle this issue sir ?

[moorepants]

I don't know how to tackle it. Maybe figure out who added them both as ask them about it.

[Shreya111111]

@moorepants can I work on this issue I think docstring style guide comes under general guidelines

[sylee957]

It can be from

https://github.com/sympy/sympy/blob/master/doc/src/contributing/documentation-style-guide.rst
https://github.com/sympy/sympy/blob/master/doc/src/contributing/docstring.rst

[sylee957]

I think that they were added in the PR #21894, so they could be intentional

[asmeurer]

The two guides have separate information. The second guide is misleadingly named because it primarily deals with things for RST files, not docstrings. The filename is more accurate. Although much of what is in it also applies to docstrings.

#21894 did intentionally split did intentionally split this, but I don't know if it's been helpful. Perhaps we should merge the two guides, and just be clear about which parts do not apply to docstrings (for example, docstrings currently cannot be written in Markdown, and cannot use different heading levels).

[moorepants]

So maybe the fix is "Documentation Style Guide" and "Docstring Style Guide" as the two names.