Silvan_WMDE created this task.
Silvan_WMDE added projects: Wikibase REST API Schema, Wikidata.
Restricted Application added a subscriber: Aklapper.
TASK DESCRIPTION
I would like to challenge the explanation that "Consistency is valuable" for
the consequent use of plurals in all path parts.
I think consistency makes sense where similar concepts are described or
things that are essentially the same. However, consistency may easily become
confusing where things are described in the same way, although they are
essentially different.
The allegedly "inconsistent" use of singular in some paths and use of plural
in other paths does make sense, where singular names describe singleton
resources and plural names describe collections. The internet is full of strong
arguments for showing that difference in a REST API's URL path (as it is full
of reasons for the opposite). So if we choose not to follow such a pattern, I
think we should document better reasons than "consistency".
Proposed alternative:
/entity/items
/entity/item/{entity_id}
/entity/item/{entity_id}/sitelinks
/entity/item/{entity_id}/sitelink/{wiki_id}
/entity/properties
/entity/property/{entity_id}
/entity/{entity_type}/{entity_id}/labels
/entity/{entity_type}/{entity_id}/label/{lang}
/entity/{entity_type}/{entity_id}/descriptions
/entity/{entity_type}/{entity_id}/description/{lang}
/entity/{entity_type}/{entity_id}/aliasLists
/entity/{entity_type}/{entity_id}/aliasList/{lang}
/entity/{entity_type}/{entity_id}/statements
/statement/{statement_id}
/statement/{statement_id}/qualifiers
/statement/{statement_id}/qualifier/{qualifier_hash}
/statement/{statement_id}/references
/statement/{statement_id}/reference/{reference_hash}
(for `aliasList` see T264543 <https://phabricator.wikimedia.org/T264543>)
TASK DETAIL
https://phabricator.wikimedia.org/T264550
WORKBOARD
https://phabricator.wikimedia.org/project/board/5003/
EMAIL PREFERENCES
https://phabricator.wikimedia.org/settings/panel/emailpreferences/
To: Silvan_WMDE
Cc: Silvan_WMDE, Aklapper, Akuckartz, darthmon_wmde, Nandana, Lahi, Gq86,
Pablo-WMDE, GoranSMilovanovic, QZanden, LawExplorer, _jensen, rosalieper,
Scott_WUaS, Wikidata-bugs, aude, Lydia_Pintscher, Mbch331
_______________________________________________
Wikidata-bugs mailing list
Wikidata-bugs@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikidata-bugs
