Page MenuHomePhabricator

Add usage instructions to "unused images" reports
Closed, ResolvedPublic

Description

With the introduction of sparql harvesting the need for instructions on how to consume the "unused images" reports has become more obvious. See e.g.

@Lokal_Profil I'm not sure if after that the workflow of adding images to the items is entirely clear. You may want to put those instructions on top of those pages (this is different for Wikidata than wikipedia-lists).

Since the pages are published on different wikis (in different languages) a template is not possible. Instead the best solution is a documentation page on commons together with a mechanism for embedding localised instructions on the page.

This can be done by:

  • changing the top of the generated reports to {{#ifexist:{{FULLPAGENAME}}/header | {{/header}} |For information on how to use this report and how to localise these instructions visit [[:c:Commons:Monuments database/Unused images]]. }} (i.e. adding a default text when no header exists).
  • update Commons:Monuments database/Unused images to have explain that:
    • the /header subpage can be used for localised instructions
    • how to add images on Wikidata and generically how to do this on lists
    • move/remove updated or unnecessary information

The /header solution additionally provides a way for wikis to categorise the report pages if they wish and a similar structure could be used for the other generated reports.

Event Timeline

@Effeietsanders @JeanFred Do you think the solution described above would work?

Updated the descriptions since some of these suggestions were already implemented

Change 380058 had a related patch set uploaded (by Lokal Profil; owner: Lokal Profil):
[labs/tools/heritage@master] Add default instructions to top of unused images reports

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

Created a patch to add the link to the top of all reports and added a section about the /header subpage to the landing page.

Lokal_Profil updated the task description. (Show Details)

Updated the Commons page with instructions. @Effeietsanders let me know if the text works.

Change 380058 merged by jenkins-bot:
[labs/tools/heritage@master] Add default instructions to top of unused images reports

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

Mentioned in SAL (#wikimedia-cloud) [2017-09-26T23:09:30Z] <JeanFred> Deploy latest from Git master: 8248ff4 (T176200)