Grants:IdeaLab/Search and categorisation tool for outreach documentation

From Meta, a Wikimedia project coordination wiki
Jump to navigation Jump to search
Search and categorisation tool for outreach documentation
A search and categorisation tool for Wikimedia related documentation using the same software as Hay's Tool Directory.
Hex icon with lightning white.svg
idea creator
Mrjohncummings
Hex icon with flask white.svg
researcher
Masssly
Hex icon with hand white.svg
volunteer
Rberchie
this project needs...
Hex icon with hand black.svg
volunteer
Hex icon with hexes black.svg
developer
Hex icon with lightning black.svg
advisor
Hex icon with bee black.svg
community organizer
join
endorse
created on19:04, 2 August 2015 (UTC)


IdeaLab beaker and flask.svg The tool is now available here, huge thanks to Hay Kranen for building the tool :)

Project idea[edit]

What is the problem you're trying to solve?[edit]

There is a great deal of Wikimedia documentation and other resources related to Wikimedia, however it is:

  • In many different places including on non Wikimedia websites
  • Hard to find

What is your solution?[edit]

A tool for documentation related to outreach related resources that is easy to use and contribute to. People will be able to add resources in any language and it will include non-Wikimedia resources hosted on external websites.

Practically it would be a version of Hay's Tool Directory for outreach documentation which would be installed on wmflabs.org, the code for Hays Tool is available on Github here.

Community involvement is needed for the project:

  • Volunteer: Adding documentation to the search tool once it has been created
  • Developer: Someone who can do the technical work, installing the tool on wmflabs
  • Advisor: Someone knowledgeable about exisiting documentation that can be added to the search tool once it has been created and to suggest a sensible categorisation process.
  • Community Organiser: Helping encourage community members to add resources to the tool
  • Researcher: Finding useful documentation to add to the search tool once it has been created

Project goals[edit]

A screenshot of Hay's Directory Tool that this tool is be based on, they would look almost identical

People are able to find resources related to outreach activities more easily

Practical steps would be:

  1. Decide on a name for the tool (needs to be descriptve of its function so that it is easily Googlable)
  2. Write text for tool front page
  3. Link to Hays Tool (many outreach related tools are already listed here)
  4. Link from Hays Tool to this tool
  5. Install this tool on wmflabs.org
  6. Update tool when updates are available
  7. Add resources to tool

Additional functionality that would be useful but is not currently available:

  • Provide a mechanism to report problems, request features, provide feedback etc
  • Ability to add information to existing entries in the database, including extra tags or descriptions in other languages, links to translations etc
  • Ability to flag entries for resources that no longer exist
  • Ability to delete not useful entries e.g nonsense or nearly blank entries

Tool wording[edit]

Text for front page of tool[edit]

Wikimedia Documentation Directory

A way to easily discover Wikimedia-related documentation including all outreach activities e.g GLAM and education.

To add a resource simply click on the Add a resource button and fill in the form, it will take around 60 minutes to appear on the tool.

For metrics and other tools please visit the Tools Directory.

Button: Add a document

Form used to add resources to tool[edit]

Wikimedia Documentation Directory

This form is to add resources to the Wikimedia Documentation Directory, once you have completed the form in will take up to 60 minutes for the resource to appear on the tool.

Please fill in this form in the language that the resource is written in. If the resource is available in more than one language please fill a form for each language

  • Question
    • Help text
  • Name of resource
    • The name of the resource
  • URL
    • The web address of the resource, please include the https://www. part of the address
  • Source
    • The name of the organisation or individual who produced the resource, for Wikimedia resources please write which site e.g Meta, Commons, Wikipedia etc
  • Language
    • The language the resource is written in
  • Description
    • Description of the resource (100 words max)
  • Tag 1
    • A word that describes the resource in some way, tags are used to help group resources together and make them easier to find. Look at some of the resources that are currently on the tool to get examples.
  • Tag 2
  • Tag 3
  • Tag 4

Get involved[edit]

Resources to add to the tool[edit]

Please add your suggestions to the discussion page

Participants[edit]

  • Volunteer I will help to add documentation to the search tool once it has been created Rberchie (talk) 20:58, 3 August 2015 (UTC)
  • Researcher Finding useful documentation to add to the search tool once it has been created →Masssly 17:02, 21 August 2015 (UTC)

Endorsements[edit]

  • A really good idea, but if the tagging from Hay's directory is used, why restrict it to GLAM and Education? Wouldn't it be suitable for all outreach documentation and resources? Ainali (talk) 20:23, 2 August 2015 (UTC)
    • Hi Ainali, I've now changed the project to encompass all outreach documentation. Mrjohncummings (talk) 07:51, 3 August 2015 (UTC)
  • A very welcome idea to make sharing more effective. Susannaanas (talk) 08:05, 3 August 2015 (UTC)
  • Brilliant idea - a much needed resource NavinoEvans (talk) 09:57, 4 August 2015 (UTC)
  • I would love to collaborate in connecting the resources and to our program toolkits development work in the evaluation portal JAnstee (WMF) (talk) 19:22, 7 August 2015 (UTC)