Skip to main content

Criar uma atribuição em grupo

Você pode criar uma atribuição colaborativa para equipes de alunos que participam do seu curso.

Who can use this feature

Organization owners who are admins for a classroom can create and manage group assignments for a classroom. Para obter mais informações sobre os administradores de sala de aula, confira "Sobre o gerenciamento de salas de aula".

Sobre atribuições em grupo

Uma atividade em grupo é curso colaborativo para grupos de estudantes em GitHub Classroom. Os alunos podem trabalhar juntos em uma tarefa em grupo em um repositório compartilhado, como uma equipe de desenvolvedores profissionais.

Quando um aluno aceita uma atividade em grupo, o aluno poderá criar uma nova equipe ou juntar-se a uma equipe existente. GitHub Classroom salva as equipes para uma atividade como um conjunto. Você pode nomear o conjunto de equipes para uma atividade específica ao criar a tarefa e você pode reutilizar esse conjunto de equipes para uma atividade futura.

Para cada atividade em grupo, GitHub Classroom cria automaticamente um repositório compartilhado para a equipe acessar. O repositório pode estar vazio ou você pode criar o repositório a partir de um repositório modelo com código inicial, documentação, testes e outros recursos. O repositório pertence à conta da sua organização em GitHub, e GitHub Classroom concede acesso a equipes que os alunos criam ou participam ao aceitar a atividade.

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 decidir quantas equipes uma atividade pode ter e quantos integrantes cada equipe pode ter. Cada equipe que um estudante cria para uma atividade é uma equipe dentro da sua organização em GitHub. A visibilidade da equipe é secreta. Equipes criadas em GitHub não aparecerão em GitHub Classroom. Para obter mais informações, confira "Sobre as equipes".

Para assistir a uma demonstração em vídeo da criação de uma tarefa em grupo, confira "Noções básicas de configuração do GitHub Classroom".

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 saber mais, confira "reutilizar caixas de diálogos".

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 tarefa.
    • Se essa for sua primeira tarefa, clique em Criar uma tarefa. Como criar sua primeira tarefa
    • Caso contrário, clique em Nova tarefa. Botão "Nova tarefa"

Configurar os fundamentos para uma atividade

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

Nomear uma atividade

Para uma atividade em grupo, GitHub Classroom nomeia repositórios pelo prefixo do repositório e pelo nome da equipe. 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 da equipe no GitHub for "student-team", o nome do repositório de tarefas para membros da equipe será assignment-1-student-team.

Digite um título para a atividade. Opcionalmente, clique em para editar o prefixo.

Assignment title and prefix

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.

Date picker for assignment deadline

Escolher um tipo de atividade

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

Definir equipes para uma atividade

Se você já criou uma atividade em grupo para a sala de aula, você pode reutilizar um conjunto de equipes para a nova atividade. Para criar um novo conjunto com as equipes que seus alunos criam para a atividade, digite o nome do conjunto. Opcionalmente, digite o número máximo de integrantes e equipes totais.

Dicas:

  • Recomendamos incluir detalhes sobre o conjunto de equipes no nome para o conjunto. Por exemplo, se você desejar usar o conjunto de equipes para uma atividade, nomeie o conjunto após a atividade. Se você desejar reutilizar o conjunto ao longo de um semestre ou curso, nomeie o conjunto após o semestre ou curso.

  • Se desejar atribuir aos alunos uma equipe específica, dê a seus alunos um nome para a equipe e forneça uma lista de integrantes.

Parâmetros para as equipes que participam de uma atividade 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 os 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.

Visibility options for assignment repositories

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

'Continue' button

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 equipe criada por um aluno. Opcionalmente, você pode escolher um repositório de modelo como código inicial para a atividade. Para obter mais informações sobre os repositórios de modelos, confira "Como criar um repositório de modelos".

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.

Using the 'Select a repository' drop-down menu to find a template repository to use as starter code for an assignment

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 o GitHub Classroom a um IDE".

Você pode optar por configurar uma tarefa com GitHub Codespaces para dar aos alunos acesso a um ambiente de Visual Studio Code baseado em navegador com uma configuração de um clique. Para obter mais informações, confira "Usar GitHub Codespaces com 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.

Using the 'Select an online IDE' drop-down menu to click an online IDE for the assignment

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

'Continue' button

Fornecendo comentários

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

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 atividade e estes são executados imediatamente toda vez que um aluno fizer envio por push para um repositório de atividade em 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 a 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 "Métodos de avaliação".

Using the 'Add test' drop-down menu to click a grading method

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.

'Save test case' button for an autograding test

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

Pencil and trash icons to edit or delete an autograding test

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 "Revisão de alterações nas solicitações de pull".

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

Checkbox for 'Enable feedback pull requests'

Para criar a tarefa, clique em Criar tarefa.

'Create assignment' button

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 as equipes que estão trabalhando em uma tarefa ou que enviaram uma tarefa na guia Equipes da tarefa. 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.

Group assignment

Monitorando o progresso dos alunos

A página de visão geral de atividades exibe informações sobre a aceitação da sua atividade e o progresso da equipe. Você pode ter diferentes informações resumidas, com base nas configurações das suas atividades.

  • Total de equipes: o número de equipes criadas.
  • Alunos cadastrados: o número de alunos na lista de participantes do Classroom.
  • Alunos que não estão em uma equipe: o número de alunos na lista de participantes do Classroom que ainda não ingressaram em uma equipe.
  • Equipes aceitas: o número de equipes que aceitaram essa tarefa.
  • Envios de tarefas: o número de equipes que enviaram a tarefa. O envio é acionado no prazo da atividade.
  • Equipes aprovadas: o número de equipes que foram aprovadas nos testes de avaliação automática para essa tarefa.

Próximas etapas

Leitura adicional