This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author anthony-flury
Recipients anthony-flury, docs@python
Date 2021-03-24.11:12:48
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1616584368.72.0.108883750732.issue43614@roundup.psfhosted.org>
In-reply-to
Content
A commonly asked question on Quora is 'What do *args and **kwargs' mean ?

While it is relatively easy for community to answer these questions the search tool on the standard documentation doesn't make it easy.

I understand that 'args' and 'kwargs' are both naming conventions, they are very common across the documentation, but searching on '*args' or '**kwargs' doesn't actually find anything useful - it certainly doesn't place 'https://docs.python.org/3/tutorial/controlflow.html#arbitrary-argument-lists' at or close to the top of the list.

It is my view that the documentation should be beginner friendly, but in this case (and many other I guess) you have to know what to search for to find something useful.

I note that even common phrases in Computing (such as 'variable arguments' or 'variable parameters') don't find anything useful. The term 'variadic' does find the relevant page, but the link displayed in the search results lands on the page (but not the relevant section) - and many beginners wont search for 'variadic'.

The index and search need to be improved to help beginners - specifically in this case
* Search Index should include common conventional names (such as args, kwargs)
* Search Index should include common computing terms ('variable arguments' for example - even if the documentation doesn't actually use that terminology).
* Search should link to the relevant section (and not just the page).
History
Date User Action Args
2021-03-24 11:12:48anthony-flurysetrecipients: + anthony-flury, docs@python
2021-03-24 11:12:48anthony-flurysetmessageid: <1616584368.72.0.108883750732.issue43614@roundup.psfhosted.org>
2021-03-24 11:12:48anthony-flurylinkissue43614 messages
2021-03-24 11:12:48anthony-flurycreate