`WebUtility.UrlDecode` does not document conversion of '+' into ' '

Open Beginner friendly
#9,442 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
Half a day
Newbie friendliness
65/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Stale
Tech stack
csharp
Domain
documentation

Research direction

Start with the WebUtility documentation pages for UrlEncode, UrlEncodeToBytes, UrlDecode, and UrlDecodeToBytes, comparing their current conversion descriptions and examples. Done means documenting space-to-plus and plus-to-space conversions where applicable, and correcting the percent-encoded examples to use uppercase %3C and %3E.

Written by the indexing model from the issue text.

Description

area-System.Runtime doc-enhancement Pri3

The documentation for UrlEncode was updated in #3124 to indicate that ' ' is converted into '+' on encode.

However:

  • The documentation for UrlEncodeToBytes needs the same update.
  • The documentation for UrlDecode and UrlDecodeToBytes needs a similar update to indicate that '+' is converted into ' ' on decode.
  • All of these pages give the example that < and > are encoded as %3c and %3e, but this is incorrect. < and > are encoded as %3C and %3E. RFC 3986 says "For consistency, URI producers and normalizers should use uppercase hexadecimal digits for all percent-encodings," and that's what the implementation does.
Dominant language
C#
Stars
950
Forks
1.7k
Avg merge
3d 5h
Merged PRs (30d)
38

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from dotnet/dotnet-api-docs

All issues in dotnet/dotnet-api-docs

Similar issues

More C# issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.