Observação: em janeiro de 2024, o GitHub Classroom mudará o modo como os repositórios de alunos são criados a partir de repositórios de código inicial. Atualmente, o processo exige que os repositórios de código inicial sejam modelos e o GitHub Classroom cria um novo repositório para cada aluno com base nesse modelo. Com a próxima mudança, os repositórios de alunos serão criados pela bifurcação do repositório de código inicial.
Essa alteração atende a um recurso frequentemente solicitado pelos professores: a capacidade de alterar o código inicial depois que uma tarefa é aceita pelos alunos.
Você pode ler mais sobre essa alteração no blog da GitHub.
Esse recurso está na versão beta pública e está sujeito a alterações.
A tarefa inicial do Git e do GitHub é um curso predefinido que resume os conceitos básicos do Git e do GitHub e fornece aos alunos links para recursos a fim de saber mais sobre tópicos específicos.
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".
Criando a atividade inicial
Se não houver recomendações na sala de aula
- Efetue o login em GitHub Classroom.
- Acesse uma sala de aula.
- Na guia Tarefas, clique em Usar tarefa inicial.
Se já existirem recomendações na sala de aula
- Efetue o login em GitHub Classroom.
- Acesse uma sala de aula.
- Na guia Atribuições, clique no link da faixa azul.
Configurar os fundamentos para uma atividade
Importe o curso introdutório para a sua organização, nomeie sua atividade, decida se deseja atribuir um prazo e escolha a visibilidade dos repositórios de tarefas.
- Pré-requisitos
- Como criar a tarefa inicial
- Como configurar os fundamentos de uma tarefa
- Como convidar alunos para uma tarefa
- Próximas etapas
- Leitura adicional
Importando a tarefa
Para importar a tarefa inicial do Git e do GitHub para sua organização, clique em Importar tarefa.
Nomeando a 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 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 poderá ver o feedback que você fornecer. Em "Visibilidade do repositório" selecione uma visibilidade.
Quando terminar, clique em Continuar. GitHub Classroom criará a atividade e direcionará você para a página da 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 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 Todos os alunos 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.
A tarefa inicial do Git e do GitHub só está disponível para alunos individuais, não para grupos. Depois de criar a atividade, os alunos poderão começar a trabalhar nela.
Próximas etapas
- Faça recomendações adicionais personalizadas para seu curso. Para obter mais informações, confira "Criar um trabalho individual", "Criar uma atribuição em grupo" e "Reutilizar uma atribuição".