Como testamos as ferramentas do StudyOutlaws e escrevemos estes guias

Como funciona

1. Construir e testar a ferramenta

   Testes automatizados rodam antes de cada lançamento.

2. Testar em jogos reais

   Mudanças em jogos ao vivo são testadas em jogos que nós criamos.

3. Escrever a partir do produto

   Entradas, mensagens e limites vêm da própria ferramenta.

4. Aprender com as execuções que falharam

   Os motivos de falha viram correções e guias de solução de problemas.

Quem escreve os guias do StudyOutlaws

Todos os guias são escritos e mantidos pela equipe do StudyOutlaws, as mesmas pessoas que constroem e operam as ferramentas. Por isso cada guia é creditado à equipe, e não a um autor com nome. Os guias ficam junto do código das ferramentas, então uma mudança em uma ferramenta e a atualização do guia correspondente podem sair juntas.

Os guias também são publicados em alemão, espanhol e português, e as traduções acompanham o texto em inglês.

O que entra em um guia

Um guia diz só o que a ferramenta faz hoje. Cada informação vem do próprio produto: os planos e os créditos de tarefa de que a ferramenta precisa, as entradas que ela aceita, os padrões e os limites das configurações e as mensagens exatas que ela mostra quando algo dá errado. Se uma ferramenta não consegue fazer algo, o guia diz isso tão claramente quanto descreve o que funciona.

Os resultados no painel dizem quais respostas são verificadas e quais vieram da IA, e os guias usam a mesma distinção. Um guia nunca promete que um professor ou uma plataforma não consegue ver algo; ele descreve o que aparece no jogo ou na conta quando a ferramenta sabe, como o nome de um bot no lobby do Kahoot.

Como funcionam os testes do StudyOutlaws

• Testes automatizados: as ferramentas do painel têm testes automatizados, inclusive para as entradas que aceitam e para as mensagens que mostram quando uma execução falha. O conjunto completo de testes roda em cada mudança proposta, e uma mudança só entra depois de passar.
• Jogos reais: quando mudamos o jeito como uma ferramenta entra em um jogo ao vivo ou o lê, nós a rodamos em jogos reais que criamos para o teste. Por exemplo, as correções de outubro de 2026 para o gerador de apelidos do Kahoot ("nickname generator"), para nomes já em uso e para links do lobby foram conferidas assim.
• Entradas que as pessoas realmente digitam: quando execuções falham por causa do que foi colado, olhamos essas entradas e ensinamos a ferramenta a lê-las ou a dizer na hora o que digitar no lugar.
• Extensão do Chrome: os guias de uma nova versão da extensão só aparecem quando a Chrome Web Store já oferece essa versão, então um guia nunca descreve uma versão que você ainda não consegue instalar.

Como os motivos de falha melhoram as ferramentas e os guias

Toda execução do painel que falha registra um código curto e um motivo simples, como um jogo que não foi encontrado ou um login que a plataforma recusou. Revisamos esses motivos de falha para encontrar bugs, reescrever mensagens que não ajudavam e decidir quais problemas precisam de um guia próprio. Os guias de solução de problemas sobre PINs do Kahoot, configurações do lobby do Kahoot, links privados do Kahoot, IDs de set do Blooket e duração das sessões do Membean foram escritos a partir desses motivos.

Uma busca de respostas que falha nunca usa créditos de tarefa, então um problema do lado da plataforma ou do nosso não custa nada para você. Bots e flooders cobram quando a execução começa, e os guias deles dizem isso.

Como as páginas são datadas

• "Publicado" é a data em que o guia apareceu pela primeira vez no site, tirada do histórico do projeto. Ela nunca muda depois.
• "Atualizado" é a data da última mudança real no conteúdo do guia. Corrigir um erro de digitação em outra página ou reconstruir o site não muda essa data, então uma data recente significa que o próprio conteúdo mudou.
• As atualizações dos guias normalmente vêm depois de uma mudança na ferramenta ou de um novo motivo de falha visto em execuções reais.

Como os números de uso são publicados

Os números de uso aparecem em uma única página, a página de estatísticas do StudyOutlaws em studyoutlaws.com/stats, nunca nos guias nem na página inicial. Ela cobre os últimos 7 dias de cada plataforma: respostas entregues, execuções concluídas no painel e a taxa de sucesso das execuções.

As contagens são arredondadas para baixo, e contagens abaixo de 100 não aparecem. A taxa de sucesso deixa de fora execuções que falharam por causa do que foi digitado, como um jogo errado ou encerrado ou um login recusado, e também é arredondada para baixo. Os números atualizam no máximo uma vez por hora.

Como avisar sobre um guia errado

Se um guia não bate com o que você vê, conte para a gente. É o jeito mais rápido de corrigir para todo mundo.

1. Abra o suporte

   Use o link "Support" desta página ou do menu do site. Você fala com a gente pelo chat de suporte, pelo Discord ou por e-mail.

2. Diga qual é o guia

   Informe o título ou o endereço e a parte que está errada.

3. Conte o que você viu

   Copie a mensagem ou o resultado exato e mais ou menos quando a execução aconteceu.

4. Não envie senhas

   Nunca envie uma senha da escola ou da plataforma. Não precisamos dela para conferir um guia.

Perguntas frequentes