…ions (#3137)

Part of #3082

3rd of probably 5 PRs.

+ Migrate annotations docs from `gazelle/README.md` to
`gazelle/docs/annotations.md`
+ Switch from table-based summary to bulleted lists
  + This will be much easier to maintain going forward.
+ Mechanical updates:
  + Wrap at ~80 chars
  + Use MyST directives and roles.

…ves (#3139)

Part of #3082

4th of probably 5 PRs.

+ Migrate directive docs from `gazelle/README.md` to
`gazelle/docs/directives.md`
+ Switch from table-based summary to bulleted lists
  + This will be much easier to maintain going forward.
+ Add dedicated sections for each directive
+ Though not filled out yet. I do plan on filling them out later, I just
can't say when.
+ Mechanical updates:
  + Wrap at ~80 chars
  + Use MyST directives and roles.