Cleanup the Polly.Core README.md

[martintmk]

Details on the issue fix or feature implementation

Contributes to #1091

Confirm the following

• I started this PR by branching from the head of the default branch
• I have targeted the PR to merge into the default branch
• I have included unit tests for the issue/feature
• I have successfully run a local build

[codecov]

Codecov Report

Patch coverage has no change and project coverage change: -0.02% ⚠️

Comparison is base (a7cb07c) 83.93% compared to head (a36f23f) 83.92%.
Report is 6 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1539      +/-   ##
==========================================
- Coverage   83.93%   83.92%   -0.02%     
==========================================
  Files         279      279              
  Lines        6523     6518       -5     
  Branches     1017     1017              
==========================================
- Hits         5475     5470       -5     
  Misses        839      839              
  Partials      209      209              

Flag	Coverage Δ
linux	?
macos	83.92% <ø> (-0.02%)	⬇️
windows	83.92% <ø> (-0.02%)	⬇️

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

see 1 file with indirect coverage changes

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[martincostello]

I mentioned it somewhere before previously, but I think this is a good opportunity to introduce MarkdownSnippets for the documentation.

This will allow us to define the snippets in code we can compile against, refactor etc. to ensure they still work, and then have them automatically copied over into the README files.

[martintmk]

I mentioned it somewhere before previously, but I think this is a good opportunity to introduce MarkdownSnippets for the documentation.

This will allow us to define the snippets in code we can compile against, refactor etc. to ensure they still work, and then have them automatically copied over into the README files.

Love this idea, do you think you can give the infra a shot? Then in follow-up I can do some cleanup.

[martincostello]

I haven't used it for a while (and you're writing the snippets here already anyway 😄), but it's used in this repo where I set it up a while ago you should be able to copy the things needed from: https://github.com/justeattakeaway/httpclient-interception

• Workflow
• Example snippet

[martintmk]

I haven't used it for a while (and you're writing the snippets here already anyway 😄), but it's used in this repo where I set it up a while ago you should be able to copy the things needed from: https://github.com/justeattakeaway/httpclient-interception

• Workflow
• Example snippet

Let me do this in follow-up.