[Chapel Merge] docs(deprecated): update uses and examples of keyword with attribute

Branch: refs/heads/main
Revision: 072effcf567422de42e62c9748d2da83aa162351
Author: arezaii
Link: docs(deprecated): update uses and examples of keyword with attribute by arezaii · Pull Request #21916 · chapel-lang/chapel · GitHub
Log Message:
docs(deprecated): update uses and examples of keyword with attribute (#21916)

This PR updates deprecated docs to include the @deprecated attribute
instead of the deprecated keyword.

As with docs(chpldoc): replace pragma 'no doc' with attribute by arezaii · Pull Request #21915 · chapel-lang/chapel · GitHub, this required
changing the code block style from Chapel to plain text as the
sphinxcontrib-chapeldomain and pygments packages both require updates to
parse attributes.

Future work will change these back to Chapel blocks once those updated
packages are available.

TESTING:

  • build docs locally and inspect deprecation page

reviewed by @lydia-duncan - thank you!

Compare: Comparing 2f7d9f5a3a3c6724e656ce5573ff76ca94471912...ca49ffcf07b38a51b9231507249bd6a97fde7ccc · chapel-lang/chapel · GitHub

Diff:
M doc/rst/developer/bestPractices/Deprecation.rst
https://github.com/chapel-lang/chapel/pull/21916.diff