chore: update documentation

[itsoyou]

SYN-121
Rendered

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 84.58%. Comparing base (d65ef91) to head (aea22a1).
⚠️ Report is 3 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #103      +/-   ##
==========================================
+ Coverage   77.26%   84.58%   +7.32%     
==========================================
  Files          13       13              
  Lines         884      902      +18     
  Branches      160      163       +3     
==========================================
+ Hits          683      763      +80     
+ Misses        126       85      -41     
+ Partials       75       54      -21     

Files with missing lines	Coverage Δ
synapse_token_authenticator/config/oauth.py	92.10% <ø> (+10.28%)	⬆️
synapse_token_authenticator/token_authenticator.py	71.42% <ø> (+2.38%)	⬆️

... and 7 files with indirect coverage changes

---

Continue to review full report in Codecov by Harness.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update d65ef91...aea22a1. Read the comment docs.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[jason-famedly]

Not sure if you were ready for this or not, but had some time and I'll be off on monday so here's something to work with. Looks much better in a lot of places, I just have questions and curiosities 😄

[FrenchGithubUser]

a few small typos :)

[jason-famedly]

Did a quick read through again. LGTM! 🚀