Integrate revised docstrings in spyder.api.plugins module

[CAM-Gerlach]

Pull Request

Pull Request Checklist

• Read and followed this repo's Contributing Guidelines
• Based your PR on the latest version of the correct branch
• Checked your code and writing carefully
• Described your changes and the motivation for them below
• Noted what issue(s) this pull request resolves, creating one if needed

Description of Changes

Requires spyder-ide/spyder#25512

• Thoroughly revise the docstring content for the spyder.api.plugins modules:
  • Ensure all modules and APIs have a proper summary line
  • Document un(der) documented public APIs
  • Greatly clarify and expand existing descriptions
  • Add all param, return and attribute types to both signatures and docstrings
  • Fix and clarify many instances of missing, incorrect or unclear param types in the signature and docstrings related to parameters accepting None and/or having a default value, and clarify in the docstring what that value is and its meaning.
  • Add and fix Sphinx roles and directives throughout
  • Fix all Sphinx broken references in the affected modules

[netlify]

❌ Deploy Preview for spyder-api-docs-preview failed.

Name	Link
🔨 Latest commit	bcfa84e
🔍 Latest deploy log	https://app.netlify.com/projects/spyder-api-docs-preview/deploys/6950f29ffb547a0008f59e5a

[ccordoba12]

Thanks @CAM-Gerlach!