Tag: semana6

Dicas de sobrevivência para a 6ª semana

Não deixem para gerar o vídeo do Gource no último minuto. Nossa intenção era gerar o vídeo no dia da apresentação (para ficar com mais galhos) mas tivemos problema e no final utilizamos o vídeo que foi gerado de teste na segunda-feira! Existem várias dicas de como fazer a instalação e configuração nos blogs das equipes dos anos anteriores. Também publicamos nosso processo e quais sites usamos para nos auxiliar;
Cuidado com os vídeos gerados pelo Gource. O nosso era criado dentro da pasta do SVN e tinha 5Gb de tamanho! Nenhum vídeo deve estar dentro do repositório do IF;
Ao colocar como referência um site e utilizar o Wayback Machine primeiro verifiquem no histórico se o conteúdo desejado já não está salvo. Não é preciso gerar um registro no dia que você pegou a referência;
Se utilizarem uma página institucional e não tiver nenhuma data de quando o conteúdo foi gerado (o que normalmente acontece), verifiquem os registro do Wayback Machine e podem colocar a data mais antiga que o conteúdo tem registro;
Pontos de melhoria geral levantados nas apresentações: apresentar todos os integrantes da equipe no início; ensaiar a apresentação e ter um script (uma ordem de quem vai falar e o que será apresentado para evitar que os integrantes fiquem perdidos e sem saber o que fazer); deixar preparado o conteúdo para apresentação offline (slides, vídeo do Gource e até o vídeo da demonstração – para caso ocorra qualquer problema com a conexão de internet do IF); se for utilizar o seu laptop para apresentar, verifique se ele tem entrada VGA (necessária para utilizar o projetor) ou leve um adaptador;
Pontos de melhoria geral levantados nas documentações: a documentação de POC deverá listar todos os recursos que a aplicação necessita e só, não é necessário conceituar a POC e nem descrever as demais atividades de entrega; citar as fontes de definições das tecnologias utilizadas; ao realizar essa definição manter uma padronização (se informar que uma biblioteca é de código aberto, informe também se as demais são ou não); revisar o documento mais de uma vez; todas as figuras devem ser citadas no texto.

Apresentação da POC

Apresentamos a nossa prova de conceito e, reutilizando as palavras usadas na apresentação inicial: “no geral, fomos bem (pelo menos queremos acreditar que fomos)“.

Tivemos alguns problemas no meio do caminho, como o fato dos nossos usuários no SVN terem sido bloqueados (já foi resolvido) e o script que utilizo para o Gource estar gerando um arquivo de log vazio (ainda não foi resolvido).

Conseguimos ajustar o LaTex para deixar os capítulos na mesma página. Não sei se é a solução mais correta ou elegante, mas para nós funcionou. 🙂 (E no final nem usamos porque ficou só um capítulo mesmo com várias seções):

{\let\clearpage\relax\par \chapter{Infraestutura}}

Na divisão das tarefas para a POC:

Eu: Documentação e vídeo do Gource;
Victor: Apresentação;
Jones: Vídeo de aderência;
Murilo e o Rodrigo: Aplicação.

Foi utilizado o vídeo do Gource que gerei para teste, então ele não teve a maior parte dos ajustes realizados:

Os problemas apontados pelos professores para a nossa POC foram:

Na documentação não precisa definição do Gource e nem das atividades realizadas para cumprir os requisitos da POC. Só escrever sobre a arquitetura da aplicação mesmo;
Evitar textos repetidos, isto é, informando a mesma coisa em seções diferentes;
Ao usar o Wayback Machine, verificar o histórico já gerado e colocar o ano da referência;
Problemas de grafia na documentação;
O nosso aplicativo teve um problema na imagem do logo do GinQuest (não subiu o ajuste que tornava a imagem responsiva). O que fazia a aplicação ser exibida corretamente no Desktop, mas quebrava no Mobile (o que contradizia o nosso documento que afirmava que a aplicação era mobile-first). Ao terminar a apresentação a gente subiu o ajuste. 😛

Vídeo demonstrando o aplicativo:

Gource

Um dos itens para entrega na apresentação do POC é um vídeo gerado pelo Gource. Eu fiquei responsável por essa tarefa. 🙂

Os vídeos gerados pelo Gource devem:

Alterar os userid do repositório por nomes dos participantes;
colocar uma imagem distinta e especifica para cada usuário;
utilizar opção –key;
utilizar as opções de caption para registrar as principais mudanças feitas no repositório;
os vídeos devem ter no máximo 1 minuto para cada bimestre;
No SVN deve ter também um arquivo bat / cmd / script contendo os comandos utilizados para criação do vídeo.

Instalação

Eu segui a publicação realizada pela equipe “Colombo Explorer” sobre a ferramenta.
Baixei o executável no site do Gource, instalei e sucesso! Ele já anexou o caminho no qual o programa foi instalado nas “Variáveis de Ambiente”, diferente do passo-a-passo que li, onde os alunos tiveram que fazer isso manualmente.

Depois só acessei via prompt de commando a pasta do nosso projeto (que já utiliza o SVN Tortoise) e digitei:
$gource
O vídeo foi exibido! 😮

Ajustes

Para os ajustes necessários e criação dos comandos, segui a publicação “Criação do Gource” da equipe Girar e também dei uma olhada na estrutura criada pelos nossos já conhecidos colegas do “WalkingPet” (Caminho no SVN: “…/S201802-QUA/TheWalkingPet/”).

Nesse repositório tem a documentação e opções do Gource (em inglês).

Conversão

Para converter o arquivo de vídeo gerado da terminação padrão do Gource (.ppm) para o .mp4 utilizei o “FFmpeg”.
Para instalar segui as orientações do WikiHow.
Depois foi feito o .bat para o comando de conversão e deu tudo certo.

teste_gource_190318
Teste do Gource. Vamos gerar outro na quinta-feira. o/ (update: não deu para gerar outro e o vídeo apresentado foi esse mesmo)