Nominal decorator function call syntax is inconsistent with regular function calls
Open
Nobody has claimed this yet.
3.7 (EOL)
docs
type-feature
- Dominant language
- Python
- Stars
- 77.2k
- Forks
- 36k
- PR merge metrics
- PR metrics pending
Description
| BPO | 32024 |
|---|---|
| Nosy | @gvanrossum, @ncoghlan, @serhiy-storchaka |
| Dependencies |
Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.
Show more details
GitHub fields:
assignee = None
closed_at = None
created_at = <Date 2017-11-14.13:09:52.051>
labels = ['type-feature', '3.7', 'docs']
title = 'Nominal decorator function call syntax is inconsistent with regular function calls'
updated_at = <Date 2017-11-15.08:57:43.038>
user = 'https://github.com/ncoghlan'
bugs.python.org fields:
activity = <Date 2017-11-15.08:57:43.038>
actor = 'serhiy.storchaka'
assignee = 'docs@python'
closed = False
closed_date = None
closer = None
components = ['Documentation']
creation = <Date 2017-11-14.13:09:52.051>
creator = 'ncoghlan'
dependencies = ['32012']
files = []
hgrepos = []
issue_num = 32024
keywords = []
message_count = 3.0
messages = ['306205', '306234', '306258']
nosy_count = 4.0
nosy_names = ['gvanrossum', 'ncoghlan', 'docs@python', 'serhiy.storchaka']
pr_nums = []
priority = 'normal'
resolution = None
stage = 'needs patch'
status = 'open'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue32024'
versions = ['Python 3.7']
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the BPO-32024 discussion and its dependency, BPO-32012, to understand the decorator-call syntax issue and the intended resolution. Then locate the relevant Python 3.7 documentation section and define the documentation change needed to explain or align the syntax; it is done when the inconsistency is clearly addressed in the docs.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python
- Domain
- documentation
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 20/100