Criar um trabalho individual

Você pode criar uma atividade para os alunos do seu curso para ser concluída individualmente.

Quem pode usar esse recurso?

Organization owners who are admins for a classroom can create and manage individual assignments for a classroom. Para obter mais informações sobre administradores da classe, confira "Gerenciar salas de aula".

Neste artigo

Sobre atividades individuais

Uma atividade individual é um curso para cada aluno que participa de um curso em GitHub Classroom. O aluno tem a intenção de concluir uma atividade individual sem ajuda de outros alunos.

Quando um aluno aceita uma atividade, GitHub Classroom cria automaticamente um novo repositório para o aluno. Os repositórios podem estar vazios ou você pode criar repositórios de um repositório modelo com código iniciante, documentação, testes e outros recursos. Cada repositório de atividade pertence à conta da sua organização em GitHub.

Cada atividade tem um título e um prazo opcional. Você pode escolher a visibilidade dos repositórios que GitHub Classroom cria e escolhe as permissões de acesso. Você também pode avaliar automaticamente as recomendações e criar um espaço dedicado para discutir a atividade com o aluno.

Você pode reutilizar atribuições existentes em qualquer outra sala de classe à qual tenha acesso de administrador, incluindo salas de aula em uma organização diferente. Para obter mais informações, confira "Reutilizar uma atribuição".

Pré-requisitos

Você deve criar uma sala de aula antes de poder criar uma atividade. Para obter mais informações, confira "Gerenciar salas de aula".

Criar uma atividade

  1. Efetue o login em GitHub Classroom.
  2. Acesse uma sala de aula.
  3. Na guia Tarefas, crie a atribuição.
    • Se essa for sua primeira tarefa, clique em Criar uma tarefa.
    • Caso contrário, clique em Nova tarefa no lado direito.

Configurar os fundamentos para uma atividade

Nomeie sua atividade, decida se deseja atribuir um prazo e escolha a visibilidade dos repositórios de atividades.

Nomear uma atividade

Para uma atividade individual, GitHub Classroom nomeia os repositórios pelo prefixo do repositório e pelo nome de usuário de GitHub do aluno. Por padrão, o prefixo do repositório é o título da atividade. Por exemplo, se você der a uma tarefa o nome "assignment-1" e o nome de usuário do aluno no GitHub for @octocat, o nome do repositório de tarefas de @octocat será assignment-1-octocat.

Em "Título da tarefa", digite um título para a tarefa. Opcionalmente, clique em para editar o prefixo.

Atribuir um prazo para uma atividade

Opcionalmente, você pode atribuir um prazo para a atividade. Em "Prazo (opcional)", clique no campo texto e, em seguida, use o seletor de data para atribuir um prazo.

Opcionalmente, para tornar o prazo uma data de corte, selecione Esta é uma data de corte. Se você usar uma data de corte, os alunos perderão o acesso de gravação aos repositórios de tarefas após essa data, a menos que recebam uma extensão. Para saber como estender os prazos de tarefas, confira "Estender o prazo de uma tarefa para um indivíduo ou grupo".

Escolher um tipo de atividade

Em "Tarefa individual ou em grupo", selecione o menu suspenso e clique em Tarefa individual. Você não pode alterar o tipo de atividade depois de criá-la. Se preferir criar uma tarefa em grupo, confira "Criar uma atribuição em grupo".

Escolher uma visibilidade para repositórios de atividades

Os repositórios de uma atividade podem ser públicos ou privados. Se você usar repositórios privados, apenas o aluno ou a equipe poderá ver o feedback que você fornecer.

Você também pode decidir se deseja conceder permissões de administrador para os alunos no repositório de uma atividade. Conceda permissões de administrador se o aluno puder executar tarefas administrativas para o repositório da atividade. Para obter mais informações, confira "Sobre repositórios" e "Funções de repositório para uma organização."

Em "Visibilidade do repositório", selecione uma visibilidade. Opcionalmente, selecione Permitir aos alunos o acesso de administrador no repositório.

Ao terminar, clique em Continuar para configurar o código inicial e um ambiente de desenvolvimento para a atividade.

Adicionar código inicial e configurar um ambiente de desenvolvimento

Opcionalmente, decida se deseja fornecer repositórios vazios ou código inicial e pré-configure um ambiente de desenvolvimento para seus alunos.

Escolher um repositório de modelo

Por padrão, uma nova atividade criará um repositório vazio para cada aluno na lista da sala de aula. Opcionalmente, você pode escolher um repositório de modelo como código inicial para a atividade. Para obter mais informações, confira "Criar uma atividade a partir de um repositório de modelo".

Observação: o repositório de modelos precisa pertencer à sua organização ou ser um repositório público no GitHub.

Em "Adicionar um repositório de modelo para fornecer o código inicial aos alunos", escolha o menu suspenso Selecionar um repositório e digite uma consulta de pesquisa. Na lista de resultados, clique no repositório modelo que você gostaria de usar para o código inicial.

Ao terminar, clique em Continuar para configurar a avaliação automática e feedback para o projeto.

Escolhendo um ambiente integrado de desenvolvimento (IDE)

Opcionalmente, você pode configurar uma atividade para usar um ambiente de desenvolvimento integrado (IDE). Os IDEs permitem que seus alunos escrevam código, executem programas e colaborem sem instalar o Git e uma cadeia de ferramentas de desenvolvimento completa no computador do aluno. Se você escolher um IDE para uma atividade, os alunos ainda poderão verificar e executar o código localmente em um computador com o o software necessário. Para obter mais informações, confira "Integrar GitHub Classroom com um IDE".

Você pode optar por configurar uma tarefa com GitHub Codespaces para dar aos alunos acesso a um ambiente do Visual Studio Code baseado em navegador com uma configuração de um clique. Para obter mais informações, confira "Usando o GitHub Codespaces com o GitHub Classroom".

Para escolher um IDE para a atividade, selecione o menu suspenso para adicionar um editor e clique no IDE que você deseja que seus alunos usem.

Fornecer feedback para uma atividade

Opcionalmente, você pode classificar automaticamente as atividades e criar um espaço para discutir cada envio com o aluno.

Testar recomendações automaticamente

Você pode usar a avaliação automática para verificar automaticamente o trabalho de um aluno para uma atividade em GitHub Classroom. Você configura testes para uma atribuição e eles são executados imediatamente sempre que um aluno faz um envio por push para um repositório de atribuição no GitHub.com. O aluno pode visualizar os resultados do teste, fazer mudanças e fazer push para ver novos resultados. Para obter mais informações, confira "Usar avaliação automática".

Em "Adicionar testes de avaliação automática", selecione o menu suspenso Adicionar teste e clique no método de avaliação que deseja usar. Para obter mais informações, confira "Usar avaliação automática".

Defina os parâmetros do seu caso de teste, como nome, comandos, entradas, saídas, tempo limite e pontos. Quando terminar, clique em Salvar caso de teste.

Adicione mais testes com o menu suspenso Adicionar teste e edite ou exclua os testes existentes com o ou .

Designar caminhos de arquivo protegidos

Se sua tarefa tiver arquivos ou diretórios que são usados no processo de avaliação ou não devem ser editados pelos alunos, você pode designá-los como caminhos de arquivo protegidos. Se um aluno editar um arquivo protegido, um rótulo será aplicado ao seu envio na página de visão geral da tarefa para que você investigue. Para obter mais informações, confira "Monitorar o progresso dos alunos com a página de visão geral da tarefa".

Os padrões para caminhos protegidos seguem regras semelhantes aos globs de nome de arquivo do shell. Ele pode conter os seguintes metacaracteres:

  • *: corresponde a qualquer arquivo. Por exemplo, * corresponde a todos os arquivos regulares, foo* corresponde a todos os arquivos que começam com foo, *foo corresponde a todos os arquivos que terminam com foo e *foo* corresponde a todos os arquivos cujos nomes contêm foo (inclusive no início ou no fim)
  • **: corresponde a diretórios recursivamente ou arquivos expansivamente. Por exemplo, .github/**/* corresponderá a todos os arquivos em .github e qualquer um de seus subdiretórios
  • ?: faz a correspondência de qualquer caractere.
  • [set]: corresponde a qualquer caractere em set(incluindo conjuntos como a-z)
  • \: escapa do próximo meta-personagem

Criar um pull request para feedback

Você pode criar automaticamente um pull request em que você pode fornecer feedback e responder às perguntas de um aluno sobre uma atividade. Para obter mais informações sobre a revisão das alterações em uma solicitação de pull, confira "Como revisar alterações nas solicitações de pull". Para obter mais informações sobre como deixar comentários em uma solicitação de pull, confira "Deixar feedback com pull requests".

Para criar solicitações de pull para a discussão de comentários, selecione Habilitar solicitações de pull de comentários.

Para criar a tarefa, clique em Criar tarefa.

Convidar alunos para uma atividade

Por padrão, GitHub Classroom habilita uma URL de convite para cada atividade que você criar. Os alunos podem aceitar e enviar a atividade enquanto a URL do convite for habilitada. Você pode compartilhar a URL com seus alunos na página inicial do curso ou onde quer que você publique as atividades. Os alunos também poderão acessar a atividade em GitHub Classroom se o aluno já tiver aceitado uma atividade para a sala de aula.

Aviso: tenha cuidado ao compartilhar URLs de convite. Qualquer pessoa com uma URL de convite para uma atividade pode aceitar o convite e associar uma conta pessoal em GitHub com um identificador na sua lista.

Você pode ver se um aluno ingressou na sala de aula e aceitou ou enviou uma tarefa na guia Lista de participantes da sala de aula da tarefa. Você também pode vincular os aliases do GitHub ao identificador da lista de participantes associado e vice-versa nesta guia. Para impedir a aceitação ou o envio de uma tarefa pelos alunos, altere o "Status da Tarefa" na exibição "Editar tarefa". Quando uma tarefa estiver Ativa, os alunos poderão aceitá-la usando o link de convite. Quando ela estiver Inativa, esse link não será mais válido.

Monitorando o progresso dos alunos

A página de visão geral do trabalho fornece uma visão geral das suas aceitações da atividade e do progresso do aluno. Para obter mais informações sobre como exibir e usar a página de visão geral da tarefa, confira "Monitorar o progresso dos alunos com a página de visão geral da tarefa".

Próximas etapas

  • Depois de criar a atividade, os alunos poderão começar a trabalhar na atividade usando os recursos do Git e do GitHub. Os alunos podem clonar o repositório, realizar commits de push, gerenciar branches, criar e revisar pull requests, resolver conflitos de merge e discutir alterações com problemas. Você e o aluno podem revisar o histórico do commit do repositório. Para obter mais informações, confira "Documentação de introdução ao GitHub", "Documentação de repositórios" e "Colaborando com pull requests".

  • Quando um aluno concluir uma atividade, você poderá revisar os arquivos no repositório ou você poderá revisar o histórico e as visualizações do repositório para entender melhor o trabalho do aluno. Para obter mais informações, confira "Visualizando dados e atividades do seu repositório".

  • Você pode fornecer comentários para uma atividade, comentando em commits individuais ou em linhas em um pull request. Para obter mais informações, confira "Fazer comentários em uma pull request" e "Criar um problema." Para obter mais informações sobre como criar respostas salvas para fornecer comentários sobre erros comuns, confira "Sobre respostas salvas".

Leitura adicional