chore(docs): review docs highlighted code snippets

[dreamorosi]

Description of your changes

As reported in the linked issue, some of the code snippets being highlighted in the docs had incorrect positioning. This meant that attention was directed towards wrong or non existing lines in those snippets.

The PR is the result of a review of all published pages and introduces a number of changes in the highlighted sections.

Once merged the it closes #1466.

Related issues, RFCs

Issue number: #1466

Checklist

• My changes meet the tenets criteria
• I have performed a self-review of my own code
• I have commented my code where necessary, particularly in areas that should be flagged with a TODO, or hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my change is effective and works
• The PR title follows the conventional commit semantics

Breaking change checklist

Is it a breaking change?: NO

• I have documented the migration process
• I have added, implemented necessary warnings (if it can live side by side)

---

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

Disclaimer: We value your time and bandwidth. As such, any pull requests created on non-triaged issues might not be successful.