Programs & Events Dashboard
Programs & Events Dashboard
Manage and track Wikimedia programs from one place with ease.
The Programs & Events Dashboard is a tool which assists the management of wiki programs and events.
Suppose that there is a wiki program, for example a wiki editing drive to improve a certain sort of content, or a wiki event, for example a wiki editing meetup at a local community center. In either of those cases, the dashboard provides the following:
- A registration button for participants to note that they are joining the program
- Tracking functions for organizers to measure and report the outcome of a program
Who should use the tool?
Find the tool at https://outreachdashboard.wmflabs.org/.
There are three main classes of users of the tool - program organizers, program participants, and observers. Organizers may set up an event page and invite anyone with a Wikimedia account to register as a participant in the program described. Organizers invite program participants to register as part of the event. After registering, participants may have no need to ever return to the event page. Many organizers will only return to the event page one time to collect an outcome report after the end of the program. Observers are users who view outcomes for programs in which they are not participants.
Organizers set up an event page with the tool. The tool prompts organizers to share a range of information about a program. Participants may later see this.
Organizers also have special userrights to do things such as to manually add or remove users from a program, open or close event page registration, and to generate outcome reports.
Organizers could be:
- Educators that are including the use of Wikipedia as an educational tool in their syllabus, and want to monitor the progress their students are making in editing contents,
- GLAM events organizers, wanting to monitor content uploads and editing,
- Affiliates staff that are running an event such as an edit-a-thon, or
- People that want to use the Dashboard to monitor progress regarding the edition of contents with a group of participants.
(There probably are more user-cases, please add them.)
Participants may register themselves as a being part of a program. Many participants will not do more than that, although participants whom the organizer encourages may use the event page as a base for collaborating with colleagues in their program.
How to sign-up to an existing program is explained in this page.
Organizers, participants, and uninvolved-third parties may visit the dashboard to view outcome reports.
Currently there is no feature to set any report as private.
Step by step instructions
For step by step instructions on how to use the dashboard, see guideline.
Frequently asked questions
Please see FAQ.
Glossary of terms
It is helpful to use a common language to discuss programs and events. Anyone managing Wikimedia projects may find it useful to learn these technical concepts:
- The dashboard is the name for this tool.
- Program is the term for any wiki project which would be tracked with the dashboard.
- Event page is the landing page in the dashboard where participants register for events. In this dashboard, sometimes the event page is called by the more general term "program page" because not all programs include an in-person event. Applications like Facebook and meetup.com use the term "event page", and this tool creates the wiki-equivalent.
- The organizer is the person who sets up an instance of an event page. This person has technical rights to control the event page they create.
- The facilitator is any collaborator of the organizer who also has some technical rights to control the event page. The organizer "owns" the event page, while facilitators do not.
- The participants register on the event page to note their participation in a program.
- A campaign is a set of individual programs which are grouped together. Each program in the dashboard is managed by an organizer, and a campaign includes a set of programs.
- A campaign organizer is the person who manages the category system which groups a set of programs together. This person could also generate collective reports including all programs in a campaign.
- An observer is anyone who accesses dashboard reports. Observers include all of the roles above, plus third-parties who have no involvement except a wish to see program information. For example, Wikimedia Foundation staff observe data, as do research organizations of all kinds. As is routine in the Wikimedia community, the default practice is to make most data publicly available.
Example use cases
Common uses in all cases are a need for program participants to register and a need to report metrics for program outcomes.
Here are some example use cases:
- A Wiki contributor hosts an in-person meetup at a library and invites anyone to join to contribute to Wikimedia projects together. At the event, the coordinator requests that attendees register themselves by clicking a "join" button. After the event, the coordinator checks the outcome report. The report lists all users who clicked the join button along with a description of what they did, including number of Wikipedia edits, uploads of files to Commons, or whatever else on any wiki project in any language. The report also summarizes the contributions of all participants collectively. A sample report might read, "10 people joined the event. During the event the group made 60 edits to 8 English Wikipedia articles."
- Instead of a Wikipedia meetup in a library, an analogous meetup is organized at a school with a class of students. All students register as program participants. The class engages with wiki projects over the period of the class. At the end of the class, the instructor reviews the outcome report to judge the engagement of students in the project.
- A multi-event campaign is proposed, designating a certain month for editing a certain type of Wikipedia article. Any program organizer anywhere can host their own event, and have their event listed and celebrated along with all others in that campaign. From the perspective of individual event coordinators, they operate the dashboard like any wiki meetup. From the perspective of the campaign coordinator, all local programs in the campaign series can be grouped together to generate a collective metrics report which is a sum of all the outcomes of all events in the campaign series.
- A staffperson at an organization is managing a partnership between their employer and Wikimedia projects, such as in a "Wikipedian in Residence" relationship or perhaps just to host events. The organization has a long-term commitment to sharing information, and so takes a long-term view of Wikipedia partnership. In this case, the organization has 1-2 experts register for a dashboard program and edit 100 Wikipedia articles in different languages, then they mostly quit contributing. After 6 months, the organization gets a report from the dashboard which describes how many people viewed the articles to which their expert contributed. The organization compares the count of wiki pageviews to the reach metrics calculated by similar dashboards for Facebook, Twitter, or any other communication platform.
Enabling automatic edits on a new wiki
As of August 2017, the Dashboard can be enabled on a wiki-by-wiki basis to make automatic edits to post program information on-wiki. This includes:
Steps to follow for community members before enabling automatic template edits in Dashboard:
- 1. Get community consensus
Start a community discussion to ensure community support for turning on automatic edits. Community consensus is required before editing is enabled.
Here is an example for opening the discussion:
I'm proposing to enable edits via Programs & Events Dashboard on this wiki. Once enabled, related activity for courses and other events on Programs & Events Dashboard would be reflected with wiki edits, as currently done on English Wikipedia with the Wiki Ed Dashboard. Here are the types of edits it can potentially make:
- Updates to a course page, showing the list of editors and the articles they work on: https://en.wikipedia.org/w/index.php?title=Wikipedia:Wiki_Ed/Community_College_of_Philadelphia/CHEM_121_-_Honors_(Fall_2016)&action=history
- Adding templates to user pages when the user joins a course: https://en.wikipedia.org/w/index.php?title=User:DrKathyShaginaw&oldid=740598305
- Adding templates to article talk pages to show who is working the article: https://en.wikipedia.org/w/index.php?title=Talk%3ARobert_E._Connick&type=revision&diff=746007336&oldid=623970628
- 2. Create the templates
Create all the templates as present here: https://en.wikipedia.org/wiki/Category:Outreachdashboard.wmflabs.org_course_templates
It would be ideal if they could be placed under a common category for future reference.
- 3. Share the created templates with User:Sage (Wiki Ed).
It would also be very helpful if you could separately send a list indicating the translated names for each of the following English templates:
- Participant editor
- Program instructor
- Program assignment
- Participants table
- Participant table row
- End of participants table
- Program details
- Start of program timeline
- Start of program week
- End of program week
News and recent changes
- You can create a 'private' program, which can only be seen by that programs facilitators and by dashboard admins. Participant usernames will not appear in the user list for associated campaigns.
- The downloadable CSV of course stats now includes retention counts, as well as per-wiki breakdowns of edit count, articles edited, and articles created.
- For the 'ArticleScopedProgram' type, you can now track entire categories, or articles that include a specific template, instead of just tracking 'assigned' articles.
- Outreachy intern Candela Jiménez Girón has started her project to improve the dashboard for Art+Feminism 2018
- If you are enrolled in an editathon, you can run a manual update of the statistics by just clicking in a button from the course actions. This will provide more accurate information of the last revisions that took place.
- A new message is displayed in beneath the course activity that informs the user when the last update of those statistics was performed and the average time left for the next update to happen. This will enable the user to be aware that their contributions may not appear as part of the statistics until the next update after the edition happens.
- When browsing the revisions, only 50 of them will appear listed, together with a "See more" button that will render 50 more if they exist. This will avoid render too many information for the user in the page.
- The campaign creator can include a Default Course Type to their campaigns so any course created from the campaign will have a determined type. It is possible to change the type of the specific course afterwards. E.g. All the users of a campaign will be by default "Edit-athons" if the user set it as Default Course Campaign for the campaign.
- The campaign creator can set a Default Passcode to a campaign so all the courses created from that campaign will have the same passcode. This passcode can be a specific one, a random one or can be set as no passcode required. It is possible to change the specific course passcode afterwards.
- The course creator can set different start and end times for the activity and statistics gathering OR for the event that will take place.
- The campaign list from the courses is now ordered alphabetically
- We've updated the OAuth login permissions, which now include permission to create new accounts. We will start testing a feature that uses this permission soon. If you run into any errors, please log out and log in again.
- The 'account requests' feature has been enabled. To use it, you must enable it in the 'Available Actions' section of a program you are the facilitator for.
- A facilitator can generate new Wikipedia accounts from the program 'Editors' tab, so we'll avoid creating too many accounts from the same IP, so Wikipedia blocks the IP for the next accounts creation.
- A participant can submit a request to create an account from the enroll link. A facilitator can then create it from the dashboard; the password will be emailed to the new editor, and they will automatically be added as a participant.
The Wiki Education Foundation originally developed the dashboard for the exclusive use of its own supported class programs on its website at https://dashboard.wikiedu.org/ in 2015. The tool at the time was imagined as a replacement for the 2011 mw:Extension:Education Program tool, which had proven to be costly to manage. Because of outside interest in Wiki Ed's tool, the organization copied their in tool in a separate website for community use and testing. By June 2016, a collaboration between Wiki Ed and the Wikimedia Foundation Community Tech team had made some commitment to offer the tool to the general Wikimedia community. From that point, the WMF Community Tech team began to develop the tool for reuse in other contexts, including outside the context of classrooms and instead for general programs and events.
A driving force behind the development of the tool is the WMF's desire for event coordinators to provide "global metrics", which is/was the Wikimedia term for all the data that program organizers should report to the WMF if they are receiving program support from the WMF.
For more documentation on technical development see also
- mw:Extension:Education Program - the tool in use from 2011-2015, and which probably is surpassed in some ways by the new dashboard tool
- mw:Wikipedia Education Program/Dashboard - MediaWiki documentation on the original dashboard at its start in October 2015
- development documentation on Phabricator
- Community Tech/Programs & Events Dashboard - the Community Tech team began developing the dashboard for general Wikimedia community use in June 2016
- GitHub repo for the software