A Transistores Lab 1 - guidiamond/Z01.1-Insonia GitHub Wiki

Devemos começar a preparar o terreno para os projetos em grupo que estarão por vir, nessa etapa você deve montar um grupo de 5/6 colegas e dar um nome a ele (os grupos são nomeados por letras, a primeira letra do nome do seu grupo deve ser aquela que foi fornecida em sala de aula).

O grupo irá trabalhar de forma colaborativa via a utilização do git/ github. É imprescindível que todos trabalhem dessa forma, pois será a maneira que iremos avaliar individualmente vocês.

1. GitHub

O git será uma das ferramentas mais importantes para o projeto, com as etapas a seguir vocês realizaram um Fork do repositório do projeto e adicionaram os colaboradores.

Fork é quando 'copiamos' um repositório para podermos trabalhar nele sem a necessidade de mexermos no original.

a. Fork

O Scrum Master do grupo (será sorteado em sala) deverá realizar o fork do repositório do projeto do computador Z01, para isso, basta acessar a página do github do projeto:

E no site clicar em fork:

Fork

Note que criar um fork é diferente de criar apenas uma cópia. No fork o seu repositório ainda possui como referência o original (/insper/Z01.1) o que possibilitará que vocês atualizem o repositório com novos materiais que serão necessários ao longo do semestre sem perder o que já foi feito e mais importante sem muito trabalho.

  • CRIAR SÓ UM FORK POR GRUPO

Alterando o nome do Fork

Acesse a página do repositório de vocês no github e vá em SETTINGS -> Repository Name -> e altere o nome do repositório para :

  • nome: Z01.1-NomeDoGrupo

b. Colaboradores

Isso irá criar uma cópia do repositório na sua conta, uma vez realizado a cópia será necessário inserir os demais colegas como integrantes desse repositório (para que eles possam propor alterações). Para isso vá até a página do repositório na sua conta e clique em Settings -> Collaborators e adicione os usuários ou e-mails dos seus colegas.

Note que todos devem ter uma conta no github já criada.

Collaborators

c. Clonando

Uma vez criado o fork* e adicionado os colegas vocês deverão clonar o repositório para o computador de vocês com o comando:

$ git clone URL_DO_FORK

Após clonar o repositório devemos baixar e atualizar os submodules, execute os seguintes comandos no terminal:

$ git submodule update --init --recursive
$ git submodule foreach 'git stash; git checkout master; git pull'

submodules são repositórios git dentro de um repositório git.

Editando nome do grupo

Após clonar o repositório o mediador desse projeto deve editar o arquivo json GRUPO.json que está localizado na raiz do projeto inserindo a letra do grupo (que foi atribuída em sala) e o nome recém criado do grupo (o nome do grupo deve ser uma frase com a primeira palavra começando com a letra do Grupo).

exemplo um grupo com a letra M, GRUPO.json:

{
  "Nome-Grupo" : "Macarrao delícia" 
}

Após editar o arquivo deve-se: fazer um commit e um push para o repositório.

Próximos passos!

Siga para o A Transistores Lab 2