Last modified: 2009-07-28 18:08:34 UTC

Wikimedia Bugzilla is closed!

Wikimedia migrated from Bugzilla to Phabricator. Bug reports are handled in Wikimedia Phabricator.
This static website is read-only and for historical purposes. It is not possible to log in and except for displaying bug reports and their history, links might be broken. See T21970, the corresponding Phabricator task for complete and up-to-date bug report information.
Bug 19970 - action=upload needs better documentation
action=upload needs better documentation
Status: RESOLVED FIXED
Product: MediaWiki
Classification: Unclassified
API (Other open bugs)
1.16.x
All All
: Normal enhancement (vote)
: ---
Assigned To: Michael Dale
: patch
Depends on:
Blocks:
  Show dependency treegraph
 
Reported: 2009-07-28 15:48 UTC by Brad Jorsch
Modified: 2009-07-28 18:08 UTC (History)
4 users (show)

See Also:
Web browser: ---
Mobile Platform: ---
Assignee Huggle Beta Tester: ---


Attachments
Patch against r53871 (4.56 KB, patch)
2009-07-28 15:48 UTC, Brad Jorsch
Details

Description Brad Jorsch 2009-07-28 15:48:21 UTC
Created attachment 6396 [details]
Patch against r53871

With 5 different "modules" in there, it needs to be better organized. I managed to figure it out by digging through the code, but we can't expect everyone to do that.

I've given it a shot in the attached patch. What I did:
* Explain the 5 different modes at the top, much like prop=revisions does.
* Mention that multipart/form-data is required for "file" and "chunk".
* Note that the session keys are tied to the current login session.
* Rearrange the parameters so "shared" parameters come first and then the various module-related parameters are grouped together.
* Revise parameter descriptions.
* Add more examples.
Comment 1 Roan Kattouw 2009-07-28 15:51:07 UTC
Michael, can you verify that Brad's descriptions are correct?

Also, it might be useful to number the different modes and indicate for each parameter which modes they can be used in (like list=deletedrevs does).
Comment 2 Michael Dale 2009-07-28 18:08:34 UTC
That looks good. added in r53885 I don't think numbering will increase clarity. Since some of the paras have an order that they need to be sent. Perhaps we link out to a mediaWiki page with some examples usage?

Note You need to log in before you can comment on or make changes to this bug.


Navigation
Links