Skip to main content

Criar um trabalho individual

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

Organization owners who are admins for a classroom can create and manage individual assignments for a classroom. For more information on classroom admins, see "About management of classrooms."

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.

Para uma demonstração vídeo da criação de uma atividade individual, consulte "Fundamentos da configuração de GitHub Classroom".

You can reuse an existing assignment in any other classroom you have admin access to, including classrooms in a different organization. Para obter mais informações, consulte "Reutilizar uma atividade".

Pré-requisitos

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

Criar uma atividade

  1. Efetue o login em GitHub Classroom.
  2. Acesse uma sala de aula.
  3. In the Assignments tab, create the assignment.
    • If this your first assignment, click Create an assignment. Criando sua primeira atividade
    • Otherwise, click New assignment. Botão "Nova atividade"

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ê nomear uma atividade como "assignment-1" e o nome de usuário do aluno em GitHub for @octocat, o nome do repositório de atividade para @octocat será assignment-1-octocat.

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

Título e prefixo da atividade

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.

Seletor de data para o prazo da atividade

Escolher um tipo de atividade

Em "Tarefa individual ou de grupo", selecione o menu suspenso e clique em Tarefa individual. Você não pode alterar o tipo de atividade depois de criá-la. Se você preferir criar uma atividade em grupo, consulte "Criar 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. For more information, see "About repositories" and "Repository roles for an organization."

Em "Visibilidade do repositório", selecione uma visibilidade. Opcionalmente, selecione Conceder acesso de administrador aos seus repositórios.

Opções de visibilidade para repositórios de atividades

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

Botão "Continuar"

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 sobre repositórios de modelos, consulte "Criar um repositório de modelo".

Observação: O repositório de modelo deve pertencer à sua organização ou ser um repositório público em GitHub.

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

Usar o menu suspenso "Selecionar um repositório" para localizar um repositório modelo e usar como código inicial para uma atividade

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

Botão "Continuar"

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, consulte "Integrar GitHub Classroom com um IDE."

You can choose to configure an assignment with GitHub Codespaces to give students access to a browser-based Visual Studio Code environment with one-click setup. Para obter mais informações, consulte "Usar 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.

Usar o menu suspenso "Selecionar um ID on-line" para clicar em um IDE on-line para a atividade

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 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, consulte "Usar avaliação automática".

Em "Adicionar testes de avaliação automática", selecione o menu suspenso Adicionar teste e, em seguida, clique no método de avaliação que você deseja usar. Para obter mais informações, consulte "Métodos de avaliação".

Usar o menu suspenso "Adicionar teste" para clicar em um método de avaliação

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

Botão "Salvar caso de teste" para um teste de avaliação automática

Você pode adicionar mais testes com o menu suspenso Adicionar teste e também pode editar ou excluir testes existentes com ou .

Ícones de lápis e lixeira para editar ou excluir um teste de avaliação automática

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 um pull request, consulte "Revisar alterações em pull requests".

Para criar pull requests para a discussão de feedback, selecione Habilitar pull requests de feedback.

Caixa de seleção para "Habilitar pull requests de feedback"

Para criar a atividade, clique em Criar atividade.

Botão "Criar atividade"

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 com o local onde você compartilha URLs de convite. Anyone with an invitation URL for an assignment can accept the invitation and associate a personal account on GitHub with an identifier in your roster.

Você pode ver se um aluno entrou na sala de aula e aceitou ou enviou uma atividade na abaLista da sala de aula para a atividade. Você também pode vincular os apelidos dos alunos de GitHub ao seu identificador de lista de participantes e vice-versa nesta aba. To prevent acceptance or submission of an assignment by students, you can change the "Assignment Status" within the "Edit assignment" view. When an assignment is Active, students will be able to accept it using the invitation link. When it is Inactive, this link will no longer be valid.

Atividade individual

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. Você pode ter diferentes informações resumidas, com base nas configurações das suas atividades.

  • Alunos cadastrados: O número de alunos na lista da sala de aula.
  • Adicionou os alunos: O número de contas de GitHub que aceitaram a atividade e não estão associadas a um identificador da lista de participação.
  • Alunos aceitos: O número de contas que aceitaram esta atividade.
  • Envios das atividades: O número de alunos que enviaram a atividade. O envio é acionado no prazo da atividade.
  • Passando em aprovação: O número de alunos atualmente em testes de avaliação automática para essa atividade.

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, consulte "Começando com GitHub, "Repositórios" e "Colaborando com problemas e 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, consulte "Visualizar dados do repositório com gráficos".

  • Você pode fornecer comentários para uma atividade, comentando em commits individuais ou em linhas em um pull request. Para obter mais informações, consulte "Comentando em um pull request" e "Abrir um problema a partir do código". Para obter mais informações sobre a criação de respostas salvas para fornecer feedback sobre erros comuns, consulte "Sobre respostas salvas".

Leia mais