Painel de Controle de Programas e Eventos (Dashboard) / Usando o Painel de Controle (Dashboard)

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 38% complete.
Other languages:
English • ‎Hawaiʻi • ‎español • ‎euskara • ‎français • ‎polski • ‎português do Brasil • ‎suomi • ‎українська • ‎العربية • ‎বাংলা • ‎中文 • ‎日本語

Programs & Events Dashboard

Manage and track Wikimedia programs from one place with ease.


Esta página de documentação é dedicada ao "Painel de Controle de Programas" (Programs and Events Dashboard), disponível em outreachdashboard.wmflabs.org. O propósito básico do painel de controle (dashboard) é prover um caminho fácil para organizar grupos de editores que estão trabalhando em projetos em comum, e tornar fácil o acompanhamento do que eles estão fazendo e como eles estão contribuindo.

É uma versão do Wiki Education Foundation’s WikiEdu Dashboard, que está disponível somente para curso realizados em universidades norte-americanas na Wikipédia em inglês. O Painel de Programas e Eventos (Programs and Events Dashboard) funciona para vários programas em diferentes idiomas assim como qualquer projeto Wikimedia.

Porque usar o Painel de Programas e Eventos?

O Painel de Programas e Eventos foi desenvolvido para o gerenciamento e acompanhamento de editores em programas que contam com:

  1. Tempo limitado: eles têm começo e fim
  2. Foco: eles não se sobrepõem a outras atividades de edição ou em atividades em que editores estão trabalhando individualmente em artigos distintos delegados a eles
  3. Trabalho colaborativo: Ele consiste num grupo específico de colaboradores com nomes de usuário rastreáveis e documentados.

Para mais informações sobre o painel de controle, veja a página principal de documentação de documentos (main documentation page) e as Perguntas Frequentes.

Noções básicas

Autenticação

Boas Vindas & Propósito do Painel de Controle (1 de 5)

A plataforma usa OAuth para logar com sua conta Wikimedia global.

Se você clicar no ícone "Sign up" sem ativar a sua conta Wikimedia, você será direcionado para a página da Wikipédia para criar a sua conta. Neste caso, uma vez que criar a sua conta e aprovar o uso do OAuth, você será direcionado de volta para o Painel de Controle.

Se você clicar no botão "Log in", você será direcionado à Wikipédia para logar, então o OAuth irá solicitar permissão para o Painel de Controle (Dashboard) interagir com as páginas usando a sua conta. Uma vez que estiver logado, você será direcionado de volta ao Painel de Controle.

‘’Nota‘’: A permissão OAuth pede para "interagir com as páginas; editar páginas existentes; criar, editar e mover páginas". Esta função é raramente usada, e não é muito aplicada nesta ferramenta.

Navegar no Painel de Controle

Note as abas Explorar e Meu Painel de Controle (Dashboard) no lado esquerdo do menu do topo da interface.

A maioria das atividades que você precisará poderá ser encontrada na aba "Meu Painel" (My Dashboard). Esta aba está posicionada no lado esquerdo do topo da página. Essa aba apresenta um portal para todas as páginas às quais você aderiu, além de oferecer a oportunidade de criar novos programas.

A primeira aba no topo, "Explorar", permite explorar programas existentes, e encontrar e clicar nas páginas de campanhas e eventos ativos. Entrar na página da campanha vai mostrar todos os eventos que são parte dessa campanha.

A segunda aba do topo, "Meu Painel", permite explorar os programas dos quais você está envolvido de alguma maneira. Essa aba também permite que você crie programas e que encontre programas para participar.

Alterando o idioma da interface

O idioma padrão da interface do Painel de Controle é o inglês ou o idioma que o seu navegador adota como preferencial.

No lado direito no topo da interface, próximo aos botões Sair e Nome de usuário, você encontra os idiomas disponíveis.

Para alterar o idioma da interface, vá até o topo da página, na direita, e clique em cima do botão referente ao idioma desejado. A ferramenta usa o mesmo tipo de seletor universal de idiomas usado no Wikipedia.

Até agora, quase todos os idiomas testados na plataforma estão funcionando. Para traduzir a interface para mais idiomas, veja o Projeto em Translatewiki. Se o script não estiver funcionando corretamente, por favor reporte enviando um e-mail para dashboard@wikimedia.org ou submetendo um problema (bug) no Phabricator.

Participando de um Programa

Passo a Passo do Painel de Controle para Participantes (2 de 5)

Você está participando de um programa ou evento (como uma maratona de edição, uma aula na universidade, ou outra situação colaborativa que envolve edição de projetos Wikimedia ou carregamento de mídias no Commons). O realizador do programa já deve ter incluído o programa no Painel de Controle; há algumas maneiras de entrar nele. Se você ainda não estiver logado no Painel de controle, veja como logar no Painel de Controle.

Se o organizador compartilhou um link com você

Organizadores de programas que criam programas no Painel de controle podem compartilhar um link para inscrição de participante, para facilitar a entrada via e-mail ou link direto. Este é o link para o programa no painel e seu código é gerado de forma randômica. O formato desse endereço de link deve parecer com o abaixo:

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

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

Se você não logou no Painel de controle, ele vai solicitar que você logue ou crie uma nova conta. Veja "Como logar no Painel de Controle". Uma vez que você esteja logado, você verá uma janela que se parece com essa.

Opções para entrar no programa

Uma vez que as opções estiverem disponíveis, clique no botão "Entrar (Join).

Parabéns, você entrou no curso!

Se você precisa encontrar um programa no Painel de Controle.

Se o organizador não compartilho ou link, você pode encontrar um programa no Painel de Controle e entrar nele. Abra the dashboard, clique no botão "Explorar" no lado esquerdo do topo da página ou no botão "Encontrar um programa".

Find a program.png

Assim você verá uma lista dos programas no Painel de controle, filtrados do mais ativo para o menos ativo.

List of programs.png

Scroll down or use CTRL+F (⌘+F on Mac computers) to find the title of your program.  Click on the title, and it will take you to the program page.  On the program page, there is a gray “Join this program” button:

Example of test course selected.png

It will open a dialogue box that asks for a password:

Enter the passcode.png

If you do not have the password, contact the program facilitator, who can share it with you.  When you click “OK”, you will be added to the program.

Starting new programs

How to Use the Dashboard (3 of 5)

If you are the host of a program or event, you need to be able to create events. There are two different ways to create a program: through creating a new one, or cloning an existing event.

To create a new program, you start by finding the "Create a new program" button on the right hand side of the screen

Creating a new event

To create an event, click the “Create a New Program +” button in your “My Dashboard” menu. This will allow you to fill out a form with the following fields:

  1. Program title (Required) -- a title which describes the program or event concisely - Once recorded this information cannot be edited
  2. Institution (Required) -- a field used to describe the host for the program - Once recorded this information cannot be edited
    • in Education Program style events, it should be the institution hosting the class participating in the program
    • in Editathon style events, this can describe the organization or institution hosting the event
    • for other program types, try to be consistent in how you organize your own events, to improve future re-discoverability of the event
  3. Home language -- the language prefix that will be most used for contributions (must select only one language. Contributions from all Wikimedia language projects are included in the program, but the article selector tool will use this home language as default and changes to the language prefix must be made manually for each article.)
  4. Home project -- the project suffix used for the principle organizing project (supports only one project. As for home language above, contributions from all projects will be included, but the article selector tool will use the home project as default, changes to the project must be made manually for each article.)
  5. Program Description -- free text field that can include long strings of text. We suggest that program descriptions include:
    • Copyable links to on-wiki organizing pages
    • A description of the basic logistics for the event
    • The program password, if you want the event to be open for registration to anyone who visits the program page (or instructions for getting the password if you want the event to be closed).
    • Copyable links to on-wiki trainings or guidance material that will strengthen participant engagement -- especially important if working with new contributors to the projects, such as during education programs or editathons with new volunteers.
  6. Start Date (Required) -- use the calendar selector or type in a date in the YYYY-MM-DD format. Especially if the event is during a window of time with other similar events, make sure to specify HH:MM.
  7. End Date (Required) -- use the calendar selector or type in a date in the YYYY-MM-DD format. Especially if the event is during a window of time with other similar events, make sure to specify 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(at)wikimedia(dot)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 adminstrative 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(at)wikimedia(dot)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.
  • 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(at)wikimedia(dot)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.

Known Issues

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(at)wikimedia(dot)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!