sqlite3: Connection.create_collation() documentation inaccuracies

[AdrianIssott]

Documentation

Currently the documentation of sqlite3.create_collation() (https://docs.python.org/3/library/sqlite3.html#sqlite3.Connection.create_collation) says:

Note that the callable will get its parameters as Python bytestrings, which will normally be encoded in UTF-8.

However, as you can see from the discussion on #92742 that's incorrect in python 3 and the callable gets its parameters as Python strs which matches the SQLite docs which says:

Collating functions only matter when comparing string values

[erlend-aasland]

Would you mind reviewing the proposed change, @AdrianIssott?

[erlend-aasland]

Resolved by:

• main: gh-92780: Improve sqlite3.Connection.create_collation docs #92790
• 3.11: [3.11] gh-92780: Improve sqlite3.Connection.create_collation docs (GH-92790) #92922
• 3.10: [3.10] gh-92780: Improve sqlite3.Connection.create_collation docs (GH-92790) #92923