Escritorio de Eventos y Programas/Utilizando el tablero

From Meta, a Wikimedia project coordination wiki
Jump to navigation Jump to search
This page is a translated version of the page Programs & Events Dashboard/Using the Dashboard and the translation is 41% complete.
Outdated translations are marked like this.

Programs & Events Dashboard

Manage and track Wikimedia programs from one place with ease.


Esta página de documentación es para el "Panel de control de programas y eventos" en outreachdashboard.wmflabs.org. El propósito básico del tablero es proporcionar una manera fácil de organizar grupos de editores que están trabajando en un proyecto común y facilitar el seguimiento de lo que están haciendo y lo que han contribuido.

Es un derivado del Panel del programa de educación de la Fundación Wikimedia, que es solo para cursos de educación impartidos por universidades norteamericanas en Wikipedia en inglés. En cambio, el Panel de programas y eventos funciona para una variedad de programas en cualquier idioma de casi cualquier proyecto de Wikimedia.

¿Por qué utilizar el panel de programas y eventos?

El panel de Programas y eventos está diseñado para administrar y rastrear grupos de editores en programas que son:

  1. De duración determinada: tienen una hora de inicio y finalización
  2. Enfocados: no se superponen con otras actividades de edición, o donde los editores están trabajando en artículos individuales y distintos que se les asignan.
  3. Basado en cohortes: hay un grupo distinto de contribuyentes cuyos nombres de usuario se pueden recuperar y documentar.

Para obtener más información sobre el panel, consulta la página de documentación principal y Preguntas frecuentes.

Aspectos básicos

Acceso

Bienvenida y propósito del tablero (1 de 5)

La plataforma utiliza OAuth para iniciar sesión en la plataforma con su cuenta global de Wikimedia.

Si haces clic en el icono "Registrarse" sin una cuenta de Wikipedia activada, te llevará a una página para crearte una cuenta de Wikipedia. En este caso, una vez que crees la cuenta y apruebes el uso de OAuth, volverás al Panel de control.

Si tienes una cuenta de Wikipedia y haces clic en el botón "Iniciar sesión", se te dirigirá a Wikipedia para iniciar sesión, luego OAuth te pedirá permiso para que el Panel de control interactúe con las páginas que utilizan tu cuenta. Una vez que hayas iniciado sesión, volverás al Panel de control.

"Nota": los permisos de OAuth solicitan "Interactuar con las páginas-Editar páginas existentes; Crear, editar y mover páginas" -- Esta función se utiliza con poca frecuencia y no es muy importante en la versión actual de la herramienta.

Navegando por el tablero

Tenga en cuenta las pestañas Explorar y Mi panel en la parte superior izquierda de la interfaz

La mayoría de las actividades que necesitarás se pueden encontrar en la pestaña "Mi panel de control". El nombre de la pestaña se muestra en la parte superior izquierda de la página. Esta pestaña proporciona un portal para todas las páginas a las que se ha unido, además de brindarle la oportunidad de crear nuevos programas.

La primera pestaña en la parte superior, "Explorar", brinda la oportunidad de explorar eventos existentes y campañas activas. Visitar la página de una campaña mostrará todos los eventos que forman parte de esa campaña.

La segunda pestaña en la parte superior, "Mi tablero", permite la exploración de programas en los que está involucrado de alguna manera. La pestaña también le permite crear programas y encontrar programas en los que participar.

Cambio de idioma de la interfaz

El idioma predeterminado de la interfaz para el panel es el inglés o el idioma en el que su navegador se comunica como preferencia.

En la parte superior derecha de la interfaz, junto a los botones Cerrar sesión y Nombre de usuario, puedes encontrar el selector de idioma

Para cambiar el idioma de la interfaz, vaya a la esquina superior derecha de la página y haga clic en el botón desplegable. La herramienta usa el mismo tipo de selector de idioma universal que usa Wikipedia.

Hasta ahora, casi todos los scripts de idiomas que se han probado en la plataforma han funcionado correctamente. Para traducir la interfaz a más idiomas, consulte El proyecto en Translatewiki. Si su script no se muestra correctamente, infórmelo enviando un correo electrónico a dashboard@wikimedia.org o enviando un error en Phabricator.

Participando en un Programa

Tablero paso a paso para los participantes (2 de 5)

Estás participando en un programa o evento (como un maratón de edición, una clase en una universidad u otra situación de colaboración que implique editar proyectos de Wikimedia o cargar contenido multimedia en Commons). El facilitador del programa ya debería haber agregado el programa al Panel de control, hay un par de formas diferentes de unirse a él. Si aún no has iniciado sesión en el Panel de control, consulta Cómo iniciar sesión en el Panel de control.

Si el organizador compartió un enlace contigo

Los organizadores del programa que crean programas en el panel pueden compartir la URL de inscripción de un participante, para unirse fácilmente al evento por correo electrónico o mediante un enlace directo en la wiki. El enlace es el enlace para el evento del programa en el panel, adjunto con un ?enroll=TOKEN# en la URL donde TOKEN# es un hash aleatorio o contraseña elegida. El enlace debería verse así:

https://outreachdashboard.wmflabs.org/courses/WMF/test?enroll=jbnkodpt

Si no ha iniciado sesión en el Panel de control, se le pedirá que inicie sesión o cree una cuenta ahora. Consulte Cómo iniciar sesión en el Panel de control. Una vez que haya iniciado sesión, verá un cuadro que se parece a este:

Opciones para unirse a un programa

Una vez que las opciones estén disponibles, haga clic en el botón “Unirse a NOMBRE DEL PROGRAMA”.

¡Felicitaciones te has unido al curso!

Si necesitas encontrar el programa en el Panel de control:

Si el organizador no ha compartido el enlace, puedes encontrar el programa en el Panel de control y unirte allí. Abre el panel, haz clic en la pestaña "Explorar" en la esquina superior izquierda o en el botón "Buscar un programa":

Find a program.png

Esto te llevará a una lista de programas en el Panel, que estarán ordenados desde más a menos activos:

List of programs.png

Desplácese hacia abajo o use CTRL+F (⌘+F en computadoras Mac) para encontrar el título de su programa. Haz clic en el título y te llevará a la página del programa. En la página del programa, hay un botón gris que dice "Unirse a este programa":

Example of test course selected.png

Se abrirá un cuadro de diálogo que solicita una contraseña:

Enter the passcode.png

Si no tiene la contraseña, comuníquese con el facilitador del programa, quien puede compartirla con usted. Al hacer clic en "Aceptar", se le agregará al programa.

Empezando programas nuevos

Cómo utilizar el panel (3 de 5)

Si eres el anfitrión de un programa o evento, necesitas poder crear eventos. Hay dos formas diferentes de crear un programa: creando uno nuevo o clonando un evento existente.

Para crear un programa nuevo, comience por buscar el botón "Crear un programa nuevo" en el lado derecho de la pantalla.

Creando un nuevo evento

Para crear un evento, haga clic en el botón "Crear un nuevo programa +" en el menú "Mi panel de control". Esto le permitirá completar un formulario con los siguientes campos:

  1. Título del programa (obligatorio): un título que describe el programa o evento de manera concisa - Una vez grabada, esta información no se puede editar
  2. Institución (obligatorio): un campo que se utiliza para describir el anfitrión del programa. Una vez registrada, esta información no se puede editar.
    • en eventos al estilo del Programa de Educación, debe ser la institución anfitriona de la clase que participa en el programa
    • en eventos de estilo Editathon, esto puede describir la organización o institución que organiza el evento
    • para otros tipos de programas, trate de ser coherente en la forma en que organiza sus propios eventos, para mejorar la posibilidad de volver a descubrir el evento en el futuro
  3. Idioma del hogar: el prefijo de idioma que más se utilizará para las contribuciones (debe seleccionar solo un idioma. Las contribuciones de todos los proyectos Wikimedia se incluyen en el programa, pero la herramienta de selección de artículos usará este idioma del hogar como predeterminado.)

Proyecto #Inicio: el sufijo del proyecto utilizado para el proyecto principal de organización (solo admite un proyecto. En cuanto al idioma del hogar anterior, se incluirán las contribuciones de todos los proyectos, pero la herramienta de selección de artículos usará el proyecto del hogar como predeterminado.)

  1. Descripción del programa: campo de texto libre que puede incluir largas cadenas de texto. Sugerimos que las descripciones del programa incluyan:
    • Enlaces copiables a páginas de organización en wiki
    • Una descripción de la logística básica del evento
    • La contraseña del programa, si desea que el evento esté abierto para el registro de cualquier persona que visite la página del programa (o instrucciones para obtener la contraseña si desea que se cierre el evento).
    • Vínculos copiables a capacitaciones en wiki o material de orientación que fortalecerán la participación de los participantes, especialmente importante si se trabaja con nuevos contribuyentes a los proyectos, como durante programas educativos o maratones de edición con nuevos voluntarios.
  2. Fecha de inicio (obligatorio): use el selector de calendario o escriba una fecha en el formato AAAA-MM-DD. Especialmente si el evento es durante una ventana de tiempo con otros eventos similares, asegúrese de especificar HH: MM.
  3. Fecha de finalización (obligatorio): use el selector de calendario o escriba una fecha en el formato AAAA-MM-DD. Especialmente si el evento es durante una ventana de tiempo con otros eventos similares, asegúrese de especificar HH: MM.
Note: you can update all of this information except for the title and institution after you create the event. If you make a mistake in either the title or the institution, you can delete the program until a participant is added to the program, then you have to ask a Dashboard admin to delete it for you by emailing dashboard@wikimedia.org.

Once you fill out the form, and click “Create my Program!” you will create the page, and as a program leader, will be able to keep updating the program page as needed (see the section below for “Updating Program Information”).

Cloning a program

Once you have been involved in a program, the "Clone Previous Program" button will appear in the dialogue following when you click on "Create a New Program" in the Dashboard

If you want to recreate a program or event that you previously facilitated or participated in, you can “clone” the program to keep the description, title and institution. To do this:

  • Go to “My Dashboard”
  • Click “Create New Program”
  • Click “Clone Previous Program”
  • In the dropdown box, choose from among your programs the one you want to clone
  • Click “Clone This Program”
  • Fill out this form as you would normally when creating a new program
  • Click “Create my Program!”

Updating Program Information

The administrative interface for a program page. Notice how the top right of the Program description and detail boxes both have "Edit" buttons for program organizers

The description and start and end time can be updated after the initial creation of an event. To modify the description, click the “Edit Description” button. To modify the start or end times or other details, click the “Edit Details” button.

Additionally, once an event is created, you can update additional information in the event, such as:

  • Facilitators — by default the program page creator is entered as a “Facilitator on the Event”. Additional facilitators can be added from among registered Wikipedians from among contributors who have signed into the dashboard before. Facilitators have the right to edit the program page.
  • Passcode — which can be used to restrict the participants in an event
  • Scheduling a data update — this requests that the servers recalculate the contributions of editors in an event (this allows for you to query historical data for past events, to see updates of data).

Deleting a Program

The administrative interface for a program page. On the right, notice the "Delete Course" button, which is only available when a program includes no participants

Only programs with no participants in them can be deleted by their facilitators. Once a participant is added to a program, email dashboard@wikimedia.org to get the program deleted.

To delete a program without participants, follow these steps:

  • Go to the program page
  • In the bottom right “Actions” section, choose the “Delete Course” button.
  • Type the title of the event in the box, to confirm you want to delete the event
  • Click the “Delete" button.
  • The event will be deleted.

Adding contributors

You can add contributors to the Program as a program leader options through the "Participation" button the Editors tab

Program leaders can add contributors directly to the event:

  • To add contributors, go to the “Editors” tab in an event.
  • Click the “Participation” button in the right hand side
  • Here you can find forms to add individual users by their username or add multiple users at once.
    • To add multiple editors at once to an event, you need to add the usernames in a text list, with returns but no other punctuation in between usernames and without the “User:” prefix.

Assigning articles to editors

For classroom assignments and some events, the program facilitators may want to assign which articles participants are working on. This feature allows facilitators to help contributors pick topics to work on, and identify the right content within the scope of the program. To assign an article, see:

  • Once a program has editors signed up, go to the “Editors” tab.
  • Click the “Assign Articles” tab
  • For each editor you should get the following options:
    • ”Assign an article” -- allows you to assign contributors which article to work on
    • ”Assign a review” -- allows you to assign contributors which article someone else is working on for peer review. This second option is an organizing tool only, it doesn’t change how metrics are tracked for individual contributor elements.
  • Click the “Done” button at the top to save

Adding suggested or “Available” articles

The articles tab within the programs and events dashboard that provides an interface for observing the worked on articles for a program

For many programs and events, you will want to offer suggested articles for folks to work on. To do this:

  • Go to the “Articles” tab in a program
  • Scroll to the bottom of the page
  • Click on the “Add an available article” button
  • Enter the article title and click “Assign”

Once these articles are available in the software, participants in the program will be able to assign themselves to each article, through their “My dashboard” section.

Tracking Wikidata items in an Article Scoped Program using Petscan

An Article Scoped Program can use Petscan output to track articles. This is particularly useful in Wikidata-focused programs, where you can use this function to track items that are the results of a specific SPARQL query.

  • Run a Petscan search on the wiki of your choice. To track Wikidata items, you can enter a SPARQL query on the Other sources tab.
  • After running the query in Petscan, note its PSID, above the results list.
  • Set your program type to be an Article Scoped Program via the Edit Details options in the Home tab.
  • In the Articles tab of your program's dashboard, enter the PSID in the Tracked Categories, PSID & Templates section.
  • Now the program will track edits to the articles/items in the result list of the Petscan query. If the query yields a large result, it can take several hours for the tracking on the dashboard to catch up.

Metrics and tracking

Across the top of each program page, is a series of numbers. These numbers are aggregate statistics compiled over the window of time described for the event in the “Program details”.

The numbers are collected once your participants start editing. The software to count these metrics sometimes takes a little while to run, but an edit should definitely be counted in the metrics within 24 hours. If metrics are not running properly, please reach out to dashboard@wikimedia.org.

Every program has a series of metrics across the top. Read this section to see those metrics explained.

The metrics data at the top of the page includes:

  • Articles Created -- this is the number of new articles created by the cohort of the users within the program. The list of articles created can also be found alongside the articles edited on the "Articles" tab [Note 1]
  • Articles edited -- this is the number of articles contributed by the cohort of users within the program.[Note 1]
  • Total edits -- this is the total number of edits from the cohort during the program timeline.[Note 1]
  • Editors -- this is the number of editors that have been added to the cohort for the program, either through self-sign up or through the program organizer enrolling them
  • Bytes added -- this is the number of bytes contributed to the project from recorded edits based on the number of bytes added per edit. [Note 1]
  • Article views-- this is a an estimate of the number of pageviews to the pages contributed to as part of the program, from the first edit to that page by an enrolled editor.
  • Commons Uploads -- this is the number of media files uploaded to Wikimedia Commons over the course of the program.

Note

  1. a b c d Note: The software only tracks contributions on the programs 'Tracked Wikis'.

Running data on historical events

Dashboard Q&A (4 of 5)

The software is capable of recovering historical data for an event which was not using the Programs and Events dashboard live for the event. To do this, simply create a program that has time and date settings in the past. Once the event is created and you have populated the event with the historical editors for the event, click the "schedule data update" button on the far right in the "Actions" section.

Note: Page view data from the point of entering contributions: the dashboard only uses pageview data from the moment in which it starts tracking the contributions of participants. It does not retrieve historical pageview data.

Campaign Feature

Campaign Feature Tutorial

The dashboard also supports “Campaigns” -- strings of events like “Art and Feminism” or a specific regional or country-level education program, where the structure and information needed for each event is similar, and there is a need to compile multiple events into one body of metrics. This feature allows you to create a campaign that can encompass many programs. You can also create a program within a campaign while having convenient access to useful program resources such as templates, program details, data tracking, etc. Overall, the feature allows you to better connect with other program organizers that are joining your campaign and visualize in one place your collective impact.

Steps for creating a campaign

To create a campaign,

  1. Start in the "Find Programs" menu
  2. At the bottom of the list of "Active Campaigns", click the "Create a New Campaign" button
  3. In the initial dialogue box for campaigns, create a title and description of that campaign. If applicable, also apply start and end dates to the campaigns (say if events are run in a series of activities). Once you have filled out these forms, click "Create a Campaign"
    • Once the campaign is created you can edit the details until someone begins creating programs within the campaign.
  4. Once the campaign is created, you can click the "Edit" button within the campaign. This allows for three options:
    • "Edit Description" which allows you to modify the description from the original template.
    • "Edit Details" which allows you to modify the core details for the campaign
    • "Edit Template" in "Program Template" section, which allows you to develop a "Program template" which can be used to share commonly needed materials or descriptions that local program leaders can use to generate pages for their local programs or events.

Creating an event within a Campaign

Once a campaign is created, program leaders can go to the main Campaign page and click "Create Program". This uses the Program template to create a pre-filled draft form, which can be used like other program creation dialogues (see above). If a program is created outside of the campaign that you would like to add to the campaign, this can be done by editing program details: Go to the page of the program, click "Edit details", and at the bottom of program details you will find the line with "Campaigns:" and "+" button. Then save your changes.

Adding new training modules

The Dashboard's training module system uses pages on Meta to create and translate training content. The training content is made up of three kinds: Libraries, Modules, and Slides. A Library is a set of one or more related Modules, and a Module is a series of Slides.

Libraries

The set of training libraries that the Dashboard knows about is defined at Training modules/dashboard/libraries. A new library should have two parts:

  1. a `.json` page that defines the libary's ID number, url slug, and the wiki page which holds the rest of the libary definition. Example: User:Ragesoss/dashboard libraries/editathons.json.
  2. a wiki page that defines the library's title, description and contents. Example: Training modules/editathons/library

To create a new library, follow the examples above and then add a link to the `.json` page to the list of libraries. The ID should be the lowest number not already taken by another library.

To add a new module to an existing library, find the wiki page that defines which modules are included and edit it. (If the modules are all listed on the `.json` page instead of on a wiki page, it will need to be converted to the wiki page format first.)

Modules

The set of training libraries that the Dashboard knows about is defined at Training modules/dashboard/modules. A new module should have two parts:

  1. a `.json` page that defines the modules ID number, url slug, the series of url slugs for each slide in the module, and wiki page which holds the rest of the details. Example User:Ragesoss/dashboard modules/wikipedia-essentials.json
  2. a wiki page that defines the module's title and description. Example: Training modules/wikipedia-essentials

To create a new module, follow the examples above, then add a link to the `.json` page to the list of modules. Use a 5-digit ID number that isn't already taken by another module, and include the ID on the page so that we can easily see which IDs are taken.

Slides

The set of training slides that the Dashboard knows about is defined at Training modules/dashboard/slides. A new slide can be created with only a wiki page, like this.

  • The slide's unique ID — followed by a dash — should be the first part of the title of the subpage. (For the example above, the ID is 10304.)
  • The url slug for the slide should be the rest of the subpage title. (For the example above, the url slug is `neutral-point-of-view`.)
  • The slide title is defined in a header at the beginning of the page. (For the example above, the title is "Pillar Two".)
  • The contents of the slide come after the header. You can use basic wikitext formatting. For images and quizzes, special templates are required. Follow the examples on existing slides: slide with an image, slide with a quiz.

Add new slides, grouped and ordered by the module they are in, to the list of slides. To make sure every slide has a different ID, the first three digits of the ID should correspond to the training module ID. For example, the 'wikipedia-essentials' module has ID 10003. Every slide in that module has an ID that starts with 103 (going from 10301 to 10322).

Supported wikitext

The Dashboard uses the wikitext of a slide page (and its translations), and converts it into the Dashboard's own data format. After extracting the slide title and the quiz template (if applicable), the rest of the wikitext is treated as content of the slide. This wikitext is converted from MediaWiki syntax to Markdown (via the Pandoc library), which is then rendered as HTML within a slide on the Dashboard. While most standard wikitext converts accurately to Markdown, no templates or transclusion will work. The Dashboard has special handling of the {{Training module image}} template, converting it to HTML that is roughly equivalent to what the template renders here on Meta. Hyperlinks should be formatted as external links, because wikilinks are treated as relative links and won't point to the same place when rendered from the Dashboard.

Activating a new module

Once you have created a new module (or updated the slides in an existing module), you can make the Dashboard refresh its content by visiting the training reload URL and specifying the url slug of the module you want to update: https://outreachdashboard.wmflabs.org/reload_trainings?module=MODULE_SLUG.

Problemas conocidos

Dashboard Conclusion and What's Coming Next (5 of 5)

Because this is a beta tool, not everything is working perfectly. Here is one of the issues that we know about that may make interfaces with the tool difficult:

  • The metrics may not be entirely reflective of your local language or project context (for example, more bytes are needed to code languages with Cyrillic script than Latin script, and "Bytes added" for the same count of symbols in different languages will be different).

A full and current list of known bugs can be found here.

Report another bug -- If you find a bug that is not listed above, please report it by emailing a description of the bug (with screenshots if possible) to dashboard@wikimedia.org or submitting the bug through Phabricator.

Give us feedback!

We do have a beta users check in meeting every two weeks for users to share how they are using the Dashboard, share any bugs they found, or ask for advice from other Dashboard facilitators. Let us know if you would like to participate!