Categoria: Apresentação

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:

Dicas de sobrevivência para a 3ª semana – parte 2

Sei que é difícil, mas tentem fazer as atividades com antecedência e mostrem para os professores. O ideal seria mostrar bem formatado e revisado, mas se não der, vai na raça mesmo. É melhor serem criticados naquele momento do que na hora da apresentação;
Usem o LaTeX (Overleaf) para já fazer o documento da proposta. O Ivan disponibiliza o modelo e já tem lá a página para criar a proposta. O ideal é todos os integrantes aprenderem a usar, pois imprevistos acontecem e não é possível depender de somente uma pessoa para resolver.
Lembre que o documento final tem que ser feito no LaTex;
No LaTeX existe maneiras diferentes para chamar a referência. Nós só usamos no formato que tinha no exemplo e algumas citações foram exibidas da maneira errada;
Se usar o LaTex e for dividir o documento em “chapters” na proposta, é necessário ajustar para que cada novo capítulo não inicie uma nova página. E também não use o “section” para esse fim (não sei explicar como fazer isso porque foi um dos problemas de formatação do nosso documento)(update: conseguimos fazer isso no documento para a POC);
A função da introdução é fazer com que o leitor tenha interesse de usar o aplicativo;
Gere um PDF e revise;
Tem nas “Dicas do Ivan” escrito que a proposta deve ser “um documento de uma a duas páginas sobre a ideia, objetivos e tecnologias a serem utilizados”. Não é bem assim! O documento deve explicar com clareza a sua proposta. A quantidade a ser escrita depende do contexto do seu aplicativo. Alguns podem explicar bem em 2 páginas e outros não. É necessário que os professores entendam como funciona o aplicativo e ter uma proposta técnica coerente. Se ainda não souberem de tudo e deixarem isso claro no documento, vai estar “tudo bem” (está entre aspas porquê será necessário decidir a arquitetura na próxima aula, então tem que ser visto isso o mais rápido possível);
Um exemplo de documentação considerada pelos professores como boa é a da equipe “The Walking Pet”. Encontre eles no SVN: “…/S201802-QUA/TheWalkingPet/“;.
A documentação e a apresentação precisam ser colocados no SVN nesse dia;
Se utilizar uma ferramenta online para o LaTex (como o OverLeaf) você tem que a cada 15 dias subir os documentos no SVN;
Tem que ser feito o vídeo da proposta inicial também! (Não fizemos e estamos atrasados! O_O);
O vídeo deve ter cerca de 5min e ter na descrição e nas tags IFSP , SPO e A6PGP.
Não entregar o vídeo na data correta significa perder pontos, porém, é melhor ter o vídeo publicado, mesmo que muito atrasado, do que não ter nenhum vídeo publicado.

Apresentação da Proposta

Apresentamos a nossa proposta e, no geral, fomos bem (pelo menos queremos acreditar que fomos).
Foi necessário realizar “alguns muitos” ajustes na proposta de um dia para o outro e tivemos um tempo limitado para ajustes e revisões. E qual o motivo disso? Deixamos para a última hora.

Sabemos que é complicado arranjar um tempo conjunto quando estamos no último semestre, trabalhamos de dia, estudamos de noite, no final de semana queremos descansar e… é pré-semana de carnaval! Trabalho tinindo porque próxima semana nada funciona! Então foram nos micro momentos que nossa documentação e apresentação foram preparadas. Cada um escrevendo no Whatsapp coisas necessárias para o documento, tirando dúvidas e compartilhando arquivos.

Deixamos para tirar dúvidas e mostrar o documento (cheio de erros) para os professores no dia anterior à apresentação!! Claro que recebemos vários puxões…

Maaaano!

Mas, graças a Deus, Eu e o Victor trabalhamos na mesma empresa então aproveitamos nosso almoço e deslocamento para a faculdade para nos reunirmos. Foram nesses momentos que fizemos o documento e a apresentação. Os demais integrantes compartilharam seus conteúdos conosco e o Murilo e o Rodrigo revisaram (bem rapidamente porque o tempo tava curto).

Os problemas apontados pelos professores para a nossa documentação foi:

Faltou um gancho da nossa introdução (que falava sobre marketing de relacionamento) com o aplicativo de gincana. Não abordamos bem o problema e como estamos solucionado ele;
Detalhar os processos e funções do aplicativo. Focamos somente no que o usuário poderia fazer nas gincanas. Deveríamos ter feito uma listagem para a parte administrativa também;
Problemas com a formatação e erros ortográficos.