[SYNPY-1423] update mkdocstrings dependency for 1.8.0

[danlu1]

Problem:

1. When using mkdocstrings < 1.8.0, custom CSS is used to define symbol type before heading and in toc.
2. We want to render cross-references for type annotations in signatures for modules from the standard library.
3. Docstrings in json_schema.py are not following Google Style.

Solution:

1. Remove the customization and implemented standard solution of showing symbol_type in headings and toc.
2. Implemented singnature cross-references
3. Update docstrings in json_schema.py

[pep8speaks]

Hello @danlu1! Thanks for updating this PR. We checked the lines you've touched for PEP 8 issues, and found:

• In the file synapseclient/services/json_schema.py:

Line 383:89: E501 line too long (147 > 88 characters)
Line 407:89: E501 line too long (147 > 88 characters)

Comment last updated at 2024-11-01 19:38:41 UTC

[BryanFauble]

I started up the mkdocs site locally and everything is looking good! Thanks for making the changes here.

I really like how signature_crossrefs is working and being able to click the signatures and be taken to the referenced types.