Replace <see href="link">text</see> with Markdown link format

[mburumaxwell]

<see href="link">text</see> tags are currently not replaced. The expected format for descriptions in OpenAPI/Swagger is markdown. Redoc does not generate a link for <see href="link">text</see> but instead displays the inner text as-is.

This PR changes the behaviour to use GitHub-flavoured markdown, instead - text tags are replaced a clickable link. Redoc supports this style of links out of the box.

[mburumaxwell]

@domaindrivendev any thoughts on this?

[mburumaxwell]

@domaindrivendev any hopes?

[Hyo-Seong]

@domaindrivendev I want it too!!

[martincostello]

Thanks for contributing - if you'd like to continue with this pull request, please rebase against the default branch to pick up our new CI.

[Hyo-Seong]

knock knock

[codecov-commenter]

Codecov Report

All modified and coverable lines are covered by tests :white_check_mark:

Project coverage is 91.70%. Comparing base (0108842) to head (5c49b58).

:exclamation: Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files

@@           Coverage Diff           @@
##           master    #2392   +/-   ##
=======================================
  Coverage   91.69%   91.70%           
=======================================
  Files          91       91           
  Lines        3022     3025    +3     
  Branches      519      519           
=======================================
+ Hits         2771     2774    +3     
  Misses        251      251           

Flag	Coverage Δ
Linux	91.70% <100.00%> (+<0.01%)	:arrow_up:
Windows	91.70% <100.00%> (+<0.01%)	:arrow_up:
macOS	91.70% <100.00%> (+<0.01%)	:arrow_up:

Flags with carried forward coverage won't be shown. Click here to find out more.

:umbrella: View full report in Codecov by Sentry.
:loudspeaker: Have feedback on the report? Share it here.