Improve tutorial through "Defining the plugin structure" section

[yeimiyaz]

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

Modify the first sections of the tutorial.

[netlify]

✅ Deploy Preview for spyder-api-docs-preview ready!

Name	Link
🔨 Latest commit	65e744c
🔍 Latest deploy log	https://app.netlify.com/sites/spyder-api-docs-preview/deploys/674d4c2954264f00085679c4
😎 Deploy Preview	https://deploy-preview-4--spyder-api-docs-preview.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[CAM-Gerlach]

Hi Yeimi! Jut FYI, after talking with Carlos I pushed commits fixing a variety of formatting and typographical issues with the tutorial, so I could continue reviewing (particularly using one sentence per line, so the substantive review comments and suggestions can be made cleanly), and to avoid bothering either of us with tedious minor fixes so we can focus on the substantive issues at hand. My review is still in progress and is rather late, but you can expect it submitted early tomorrow. Thanks!

[CAM-Gerlach]

Just FYI, I pushed a few additional changes fixing unambiguous textual issues (grammar, punctuation, capitalization, etc.), leaving more non-trivial things like repetition, phrasing, wordiness and content-relevant changes for suggestions in this PR. I also made a commit applying and fixing RST/Sphinx formatting, and one adding ref labels for the sections and topics and linking to them where appropriate.

[CAM-Gerlach]

Thanks Yeimi! Just had some remaining comments

[CAM-Gerlach]

Ended up having some more substantive changes than I thought since once I read them carefully, many of the sentences here were confusing or ambiguous.

[CAM-Gerlach]

For some reason, it didn't automatically mark all of the batched suggestions as resolved, even though it did successfully apply them. Never seen that before...

[CAM-Gerlach]

LGTM now, thanks so much for your great work @yeimiyaz !

[ccordoba12]

Thanks @yeimiyaz and @CAM-Gerlach for your work on this!