Page MenuHomePhabricator

Pywikibot: Add missing docstring params
Open, LowestPublic

Description

Pywikibot is a Python-based framework to write bots for MediaWiki (more information).

Each function of the library should have the description of its parameters in its documentation. This doc is present in-code, below the function declaration.

You need to find at least five params without description in the _pywikibot_ directory, understand the part of code to know what it does, add the following desc, and submit your change. Please take the time to understand the syntax of already present description fields to follow it.

You are expected to provide a patch in Wikimedia Gerrit. Documentation on Gerrit is available.

Event Timeline

Restricted Application added subscribers: pywikibot-bugs-list, Aklapper. · View Herald Transcript

This was already created as https://codein.withgoogle.com/dashboard/tasks/6189366353330176/ ; I am just creating a Phab task for it.
All commits should reference this Phab task

I will help with mentoring too

@jayvdb I would like to work on this task.

@jayvdb I would like to work on this task.

Upload some first patch and we will review it.
I will help if needed. I will also answer any question :)

Change 481332 had a related patch set uploaded (by AdityaJ; owner: AdityaJ):
[pywikibot/core@master] Pywikibot: Add missing docsting params

https://gerrit.wikimedia.org/r/481332

@jayvdb I uploaded the patch but the basic build is failing. I can't figure out the reason behind it. Could you please review the patch https://gerrit.wikimedia.org/r/481332

Change 481332 merged by jenkins-bot:
[pywikibot/core@master] Pywikibot: Add missing docsting params

https://gerrit.wikimedia.org/r/481332

@Dvorapa, I am interested in working on this bug with others from my undergraduate computer science open source class. Is there any area of the code where working on this bug will do the most good?

Hello, this issue is spread through the whole library. To find some, you can use documentation pages themselves (instead of source code): https://doc.wikimedia.org/pywikibot/master/

Change 548817 had a related patch set uploaded (by Morgan11235; owner: jbowen2):
[pywikibot/core@master] component: Updates to docstring params

https://gerrit.wikimedia.org/r/548817

Change 548817 merged by jenkins-bot:
[pywikibot/core@master] component: docstring update patch for comments

https://gerrit.wikimedia.org/r/548817

I would like to work on this task.

Awesome! Ask for any help if needed

Resetting assignee as the patch by Morgan11235 has been merged and as others could work on other occurrences of this task.

Change 644961 had a related patch set uploaded (by Shubham656jain; owner: Shubham656jain):
[pywikibot/core@master] Add docstrings to catall.py, change_pagelang.py, claimit.py

https://gerrit.wikimedia.org/r/644961

Change 644961 merged by jenkins-bot:
[pywikibot/core@master] Add docstrings to catall.py, change_pagelang.py, claimit.py

https://gerrit.wikimedia.org/r/644961

Change 697444 had a related patch set uploaded (by Zabe; author: Zabe):

[pywikibot/core@master] [doc] redirect.py: add missing docstring params

https://gerrit.wikimedia.org/r/697444

Change 697444 merged by jenkins-bot:

[pywikibot/core@master] [doc] redirect.py: add missing docstring params

https://gerrit.wikimedia.org/r/697444