Perguntas frequentes

Uma seleção de perguntas frequentes


Quem está por trás do Exercism?

Os dois cofundadores do Exercism são a Katrina Owen e o Jeremy Walker.

O Exercism foi fundado originalmente pela Katrina, uma programadora poliglota e vencedora do prémio «Ruby Hero» que se tornou programadora por acaso, enquanto tirava um curso de biologia molecular. Começou a analisar código ao pormenor em 2006, enquanto era voluntária no JavaRanch, e ficou viciada. Quando programa, o seu foco está na automação, na otimização de fluxos de trabalho e na refatoração. Tem o open source muito a peito e contribui para vários projetos fora do Exercism.

Em 2016, o Jeremy juntou-se como cofundador e é atualmente o CEO do Exercism. O Jeremy é um empreendedor social e programador, apaixonado pela igualdade e por criar oportunidades para todos. Além do Exercism, é cofundador da plataforma de bem-estar e construção de equipas, a Kaido.

Além desta equipa de liderança, o Exercism tem uma pequena equipa a tempo inteiro e a tempo parcial e conta com o apoio de milhares de voluntários fantásticos que criaram os vários percursos de linguagem e exercícios que tornaram o Exercism tão popular.

Sabe mais sobre os nossos mentores, os nossos mantenedores de percursos e os nossos milhares de contribuidores.

Qual é a história por trás do nome «Exercism»?

Apesar de estar a uma única vogal de «exorcism», o nome não tem nada a ver com demónios nem com corrigir «código maligno».

É, isso sim, um trocadilho com a palavra «exercise». A forma como a Katrina passou a pensar em cada exercício é que eles são pequenos, triviais e aparentemente simples. No entanto, quando se trata de resolver um exercício, o diabo está muitas vezes nos detalhes. Por outras palavras, esse exercício simples torna-se de repente mais desafiante quando pensas nos detalhes mais finos.

Para saberes mais sobre o que significa o diabo estar nos detalhes, vê as palestras Here Be Dragons e One Small Step da Katrina.

O essencial

Estou perdido. Para onde vou?

Estás com sorte. Aqui está um guia passo a passo para começares.

Se algo ainda não estiver claro para ti ou não estiver a funcionar, pode acontecer o mesmo a outras pessoas, por isso agradecemos que nos avises no fórum.

Recebo o erro "Sorry, we could not authenticate you from GitHub" ao tentar iniciar sessão. O que devo fazer?

Isto significa que o GitHub não está disposto a verificar quem és. Pode dever-se ao facto de teres optado por não dar permissão ou ao facto de a tua conta GitHub não estar corretamente configurada. Um problema comum é não teres verificado o teu endereço de email no GitHub. Podes verificar isso nas tuas definições de email do GitHub.

Como elimino a minha conta?

Podes eliminar a tua conta seguindo a ligação no fundo da tua página de definições. Se o teu problema estiver relacionado com emails e notificações, podes ajustá-lo nas tuas preferências pessoais.

O que é que tenho de fazer para resolver um exercício?

Quando começas a trabalhar num exercício, tens uma «solução esboço» que precisas de completar e tens um conjunto de testes completo que representa os requisitos que a tua solução tem de cumprir. Esta metodologia de desenvolvimento é uma forma de Desenvolvimento Orientado por Testes.

Como desbloqueio exercícios?

Por predefinição, os percursos com Exercícios de Aprendizagem exigem que resolvas Exercícios de Aprendizagem para desbloquear outros exercícios (cada um deve demorar cerca de 5 minutos a resolver, se fores fluente numa linguagem). A isto chama-se Modo de Aprendizagem.

Embora recomendemos o Modo de Aprendizagem para progredires num percurso, podes mudar para o Modo de Prática para desbloquear todos os exercícios. Para mais informações, consulta como desbloquear exercícios.

Porque é que os exercícios que tinha desbloqueado no site antigo ficaram bloqueados?

Por predefinição, os percursos com Exercícios de Aprendizagem exigem que resolvas Exercícios de Aprendizagem para desbloquear outros exercícios (cada um deve demorar cerca de 5 minutos a resolver, se fores fluente numa linguagem). A isto chama-se Modo de Aprendizagem.

O Modo de Aprendizagem é a predefinição para qualquer utilizador que tenha usado uma versão anterior do Exercism. Por isso, os utilizadores que regressam podem descobrir que exercícios que antes estavam disponíveis agora ficaram bloqueados.

Embora recomendemos o Modo de Aprendizagem para progredires num percurso, podes mudar para o Modo de Prática para desbloquear todos os exercícios. Para mais informações, consulta como desbloquear exercícios.

Cliente de linha de comandos do Exercism

Não consigo submeter! O que devo fazer?

O novo site tem um cliente de linha de comandos completamente novo e também precisa de alguns metadados extra para o teu exercício. Lê como atualizar o teu cliente de linha de comandos e migrar as tuas soluções para o novo site.

Se isso não ajudar, ou se não usavas a versão antiga do cliente de linha de comandos, lê o guia passo a passo do cliente de linha de comandos. Se isso também não ajudar, publica uma mensagem no fórum e ajudamos-te a resolver a situação.

Como verifico a versão do meu cliente de linha de comandos?

O comando de versão exercism version apresenta a versão em execução do cliente de linha de comandos do Exercism. Ao executar o comando de versão com a opção exercism version --latest, podes verificar se está disponível uma versão mais recente.

Como atualizo para a versão mais recente do cliente de linha de comandos?

O comando exercism upgrade atualiza para a versão mais recente disponível do cliente de linha de comandos, caso exista.

Recebo erros de permissão negada ao atualizar! O que devo fazer?

Se estás a receber erros de permissão negada ao tentar atualizar o cliente de linha de comandos, é provável que o binário tenha sido instalado através de um gestor de pacotes do sistema (por exemplo, o Homebrew) ou tenha sido instalado numa pasta à qual já não tens acesso de escrita.

Se o teu cliente de linha de comandos foi instalado através de um gestor de pacotes, usa esse gestor de pacotes para atualizar, em vez de executar o comando exercism upgrade.

Se o teu cliente de linha de comandos foi instalado manualmente, verifica o caminho do cliente de linha de comandos do Exercism com which exercism no Linux e no macOS, e where exercism no Windows, e certifica-te de que o caminho devolvido é uma pasta que tu criaste. Se for o caso, usa as ferramentas do teu sistema para alterar as permissões da pasta e conceder acesso de escrita ao teu utilizador, e tenta atualizar novamente. Se não tiveres a certeza de que foste tu que criaste a pasta, ou se o caminho devolvido for um caminho do sistema, usa as ferramentas do teu sistema para desinstalar o cliente de linha de comandos e volta a instalá-lo com o guia interativo.

Recebo a caixa de diálogo de erro "16-bit MS-DOS Subsystem" depois de atualizar no Windows. O que devo fazer?

Antes da versão 3.0.5 do cliente de linha de comandos do Exercism, havia um erro no comando de atualização que substituía o ficheiro binário do cliente de linha de comandos por um único ficheiro de texto, causando o erro «16-bit MS-DOS Subsystem». Para resolver este problema, remove o binário corrompido e reinstala o cliente de linha de comandos com o guia interativo.

Modo de Mentoria

A minha fila de mentoria não é atualizada há algum tempo. Estará alguma coisa errada?

Embora os tempos de espera possam ser mais longos do que o normal por vários motivos (número de mentores, altura do ano), também pode parecer que a fila não está a atualizar. Não é invulgar e deves começar a ver movimento em breve. Se a tua espera for muito superior à média, consulta Abrir um problema mais abaixo.

Quantos mentores tem o meu percurso? Só vejo alguns no site.

O site só mostra os mentores que forneceram informações biográficas para o site, não o número real de mentores que estão a analisar soluções ativamente. Fica descansado, há mentores a trabalhar nas suas filas, por isso não desanimes!

Submeti a solução / o ficheiro errado. O que posso fazer?

Na página do exercício em questão, vai a «As tuas iterações». Se a iteração indesejada estiver recolhida, clica na seta com o círculo. No menu «pontos», seleciona «Eliminar iteração».

Como posso denunciar abusos ou exemplos de má mentoria?

Consulta o nosso Código de Conduta para mais informações sobre as nossas expectativas de comportamento. Se quiseres denunciar algo, contacta-nos através de abuse@exercism.org e tentaremos corrigir ou resolver o problema, respeitando-te a ti e à tua privacidade.

Porque é que não posso dar feedback sobre representações?

Para dar feedback sobre representações de um percurso, tens de cumprir os três critérios seguintes:

  1. Estar a dar mentoria no percurso
  2. Ter dado mentoria em pelo menos 100 discussões concluídas desse percurso
  3. Ter uma classificação de satisfação global de pelo menos 95%

Melhorar o Exercism

Isto é ótimo! Como posso participar?

Há algumas formas diferentes: tornares-te mentor, gerires um percurso de linguagem ou reportares (ou resolveres!) problemas no GitHub. Podes ver mais na página Como Contribuir.

Como é que novos percursos de linguagem são adicionados ao site?

Um novo percurso de linguagem é criado quando um membro da comunidade assume a liderança e se torna mantenedor do percurso. Se quiseres ajudar a criar um, há instruções aqui.

Avisar-nos quando algo está errado

Se encontrares algo errado, avisa-nos criando um tópico no fórum.

Antes de criares um tópico, certifica-te de que verificas se já existem discussões. Experimenta algumas palavras-chave diferentes.

E se o meu problema não estiver listado aqui nem no fórum?

Se o teu problema ainda não foi resolvido nem reportado, cria uma nova publicação no fórum.

Certifica-te de que incluis as seguintes informações:

  1. A saída do comando exercism troubleshoot (para problemas com a CLI)
  2. Detalhes sobre o problema que estás a ter
  3. Instruções sobre como reproduzir o problema
  4. Se aplicável, referência a qualquer problema relacionado, usando o número do problema (no formato #1203)

E se houver um problema com a linguagem no site?

Se o teu problema estiver relacionado com um exercício do teu percurso de linguagem, encontra o percurso de linguagem correto nesta lista e submete lá um problema. Especifica se o problema é nas instruções ou algo específico da linguagem, usando o modelo abaixo.

Se detetaste um erro tipográfico ou se tens uma sugestão para tornar a linguagem ou as instruções do site geral mais claras, cria um novo tópico no fórum com as seguintes informações:

  1. Ligação para a página onde está o problema
  2. Explicação do que é o erro ou do que está pouco claro
  3. A alteração que propões