python / python/cpython

docs: improve explanation of the `errors` argument of `urllib.parse` functions

Open
#125,188 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

docs
Dominant language
Python
Stars
77.2k
Forks
35.9k
PR merge metrics
PR metrics pending

Description

Documentation

The URL quoting/unquoting functions in urllib.parse all have an errors argument, which is passed on to internal encode and decode functions.

The full explanation of what errors means is only explained in urllib.parse.quote.
The documentation for the other functions explains the the default behavior, but not any alternatives.

Each other function's documentation should should point to urllib.parse.quote for an explanation of errors.

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.

Research direction

Read the urllib.parse documentation for quote and the other URL quoting and unquoting functions. Use quote's existing explanation of the errors argument as the reference, then ensure each other function points to it and run the relevant documentation build to check the links and wording.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.