https://bugzilla.wikimedia.org/show_bug.cgi?id=34967
Web browser: ---
Bug #: 34967
Summary: FeaturedFeeds API documentation is unclear
Product: MediaWiki extensions
Version: any
Platform: All
OS/Version: All
Status: NEW
Severity: normal
Priority: Unprioritized
Component: FeaturedFeeds
AssignedTo: [email protected]
ReportedBy: [email protected]
Classification: Unclassified
Mobile Platform: ---
The current documentation for action=featuredfeeds reads:
---
* action=featuredfeed *
Returns a user contributions feed
This module requires read rights
Parameters:
feedformat - The format of the feed
One value: rss, atom
Default: rss
feed - Feed name
This parameter is required
One value:
language - Feed language code. Ignored by some feeds.
Examples:
Retrieve feed `featured'
api.php?action=featuredfeed&feed=featured
---
I find this documentation incredibly confusing.
First, "Returns a user contributions feed". Is this true? You're not inputting
a username or user ID to get a list of contributions, so this seems to be at
least misleading.
Second, the "feed" parameter is associated with some kind of magical "Feed
name". It's a required parameter without a default (apparently) and the
possible values are... null (though it only takes one!).
Third, the "language" parameter doesn't specify what kind of language code
you're looking for. Two letters? Three letters?
The example also doesn't really make much sense to me, though perhaps I'm just
being thick.
--
Configure bugmail: https://bugzilla.wikimedia.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are on the CC list for the bug.
_______________________________________________
Wikibugs-l mailing list
[email protected]
https://lists.wikimedia.org/mailman/listinfo/wikibugs-l
