Integrate revised docstrings in the spyder.api.shellconnect 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

Description of Changes

Requires spyder-ide/spyder#25515

• Thoroughly revise the docstring content for the spyder.api.shellconnect 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	a334b1b
🔍 Latest deploy log	https://app.netlify.com/projects/spyder-api-docs-preview/deploys/6955ba53b5b6be00082aa660

[ccordoba12]

Thanks @CAM-Gerlach!