[too-many-positional-arguments] Better documentation following questions

[Pierre-Sassoulas]

Type of Changes

	Type
✓	📜 Docs

Description

Add clearer explanation for those who don't know about special parameters, cleanup remnant of the time the check was not implemented in pylint and only reserved the msgid/symbol to mirror ruff.

See https://github.com/astral-sh/ruff/issues/8946\#issuecomment-2437547742

[Pierre-Sassoulas]

@flying-sheep I credited you as co-author in the commit if you don't mind.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 95.80%. Comparing base (71e2d0f) to head (8e238ba).
Report is 59 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main   #10049   +/-   ##
=======================================
  Coverage   95.80%   95.80%           
=======================================
  Files         174      174           
  Lines       18937    18937           
=======================================
  Hits        18143    18143           
  Misses        794      794           

[jacobtylerwalls]

Great! Left some minor suggestions.

[Pierre-Sassoulas]

Thank you ! Minor suggestions, major improvement 👌 I tried to reuse the ``----- Keyword```from the python doc, then black destroyed everything by autoformatting, then I forgot to document in proper English 😄

[mbyrnepr2]

Perhaps for another day - but currently we raise this message for positional-or-keyword arguments which is potentially problematic since we don't know if the function will be called with keywords or not.

[jacobtylerwalls]

Perhaps for another day - but currently we raise this message for positional-or-keyword arguments which is potentially problematic since we don't know if the function will be called with keywords or not.

I guess I don't see that as a problem. I think the point of this message is that since you don't know whether it will be called with keywords or not, you should force extra arguments to be called by keyword.