# Dicas/Regras/Sugestões para projeto de dissertação, para a dissertação e para a apresentação/defesa

###### tags: `misc`

Por favor, ler com cuidado antes de começar a trabalhar. As regras que se aplicam à dissertação são especialmente importantes, já que se forem seguidas evitam muita onerosidade na parte da revisão.

## Pesquisas Bibliográficas
Para a parte do estado da arte ou traballho relacionado, devem favorecer, **por esta ordem**:
1. Artigos científicos em revista;
2. Artigos científicos em conferência;
3. Livros;
4. Teses e dissertações;
5. Relatórios técnicos reconhecidos;
6. Referências eletrónicas (artigos, posts, etc.);

**Nunca** usar a *wikipedia* como referência bibliográfica (embora possam usar sem citar, claro).

### IEEExplore
Uma ferramenta excelente para fazerem pesquisas bibliográficas é o IEEExplore (http://ieeexplore.ieee.org/). Se acederem dentro da rede da UBI conseguem normalmente ter acesso ao pdf gratuitamente.

Caso não estejam dentro da UBI, podem conseguir uma VPN da seguinte forma (instruções para Linux e MAC):
Ligar via SSH usando o seguinte comando e credenciais da minha.ubi
> ssh [e-mail] -ND 8080
(inserir password ubi)

No Firefox, configurar o *network proxy SOCKS Host* para *localhost* porta 8080.

## Dicas para Escrita da Dissertação

### Gerais
Dicas úteis para o português(esa) que está a pensar em Português quando escreve em Inglês no link:
* http://www.ncbi.nlm.nih.gov/pmc/articles/PMC3935133/
Sugiro fortemente a leitura do artigo acima indicado.

Ferramentas para identificação de problemas sintáticos, de concordância, e outros em:
* https://www.languagetool.org/
* http://www.expresso-app.org/
Sugiro fortemente a utilização destes recursos aquando da escrita de relatórios, especialmente o Language Tool. O processo é simples:
* escrever o texto;
* fazer *copy/paste* de uma secção para a ferramenta;
* carregar em *"Check text"* ou *"Analyze text"*;
* corrigir o que houver a corrigir;
* *copy/paste* novamente para o documento.

Atenção: a segunda ferramenta (http://www.expresso-app.org/) chega a fazer sugestões, em termos de sinónimos, para melhorar o texto. Contudo, esta funcionalidade deve ser usada com cautela, porque nem sempre a sugestão serve no contexto.

Para **significados de palavras em Língua Portuguesa**, o ideal é o dicionário da Porto Editora em
* http://www.priberam.pt/DLPO/
**Note que os estrangeirismos** (palavras em língua estrangeira à que está a ser escrita a dissertação) **devem estar em itálico**. Por vezes, a visita a dicionários ajuda a perceber se a palavra já é considerada nativa ou não.

Finalmente, para escrita em colaboração de documentos LaTeX online, pode experimentar:
* https://www.overleaf.com/

Contudo, a instalação do sistema LaTeX localmente deve ser sempre a opção preferida para a escrita de relatórios.

### Conteúdo da Dissertação

* Podem escrever em Inglês (preferível) ou em Português;

* O corpo da dissertação deve ter um mínimo de 50 páginas;

* Atenção que o tipo de letra da dissertação é **Georgia**!

* A capa deve ter o novo símbolo da UBI. Ver
http://www.ubi.pt/Ficheiros/Menus/1/logo_ubi_vprincipal.jpg;

* A lista de acrónimos deve `\usepackage{acronym}`. Todos os acrónimos têm de ser invocados corretamente;

* Os acrónimos devem estar listados por ordem alfabética:

* Os acrónimos devem estar alinhados. Para isso, devem usar `\begin{acronym}[MAIOR ACRONIMO USADO NO DOCUMENTO]`:

* Quando colocarem acrónimos em legendas de figuras ou títulos de capítulos ou secções, certifiquem-se que usam comandos como `\acs*{}` (notar o `s` e o `*`). Por exemplo: `\section{Protocolo \acs*{TCP}}`. O uso do `s*` força a que a versão curta *(short)* e que o acrónimo não conte para a primeira definição do mesmo (caso contrário o acrónimo fica definido no índice de figuras, tabelas ou índice geral;

* Se não houverem tabelas na dissertação, retirem o índice de tabelas;

* O capítulo 1 deve ter a estrutura geral do documento (i.e., a descrição dos capítulos). Cada capítulo deve ter, na parte introdutória, a descrição da estrutura geral desse capítulo. I.e., deve existir um parágrafo no final da Introdução de cada capítulo com algo semelhante a: A secção 2.2 discute a implementação (...). A secção 2.3 descreve (...);

* O Capítulo 2 será o do *Related Works*. Este capítulo deve ter revisões de artigos do estado da arte ou relacionados. Estas revisões são de 1 parágrafo por cada artigo / referência que encontrarem; 2 parágrafos (ou mais) para os artigos mais próximos do vosso trabalho;

* Cada capítulo (exceto o primeiro e o último) tem uma Introdução e uma Conclusão;

* Façam um esforço para escreverem uma dissertação simétrica (5 capítulos, 5 secções em cada);

* Todas as figuras e tabelas devem ter legenda;

* Todas as figuras e tabelas devem ser descritas (mesmo que brevemente) no texto. Se não forem, não devem estar no documento;

* Quando citarem uma figura usem o comando `\ref{label-figura}`. O comando `\ref` deve estar ligado à palavra anterior (figura ou tabela) por um `~` (tilde). I.e., `A figura~\ref{fig1} demonstra...`;

* Excertos de código só devem estar no corpo do documento se forem fulcrais para a explicação (e.g., são a instanciação de um pequeno algoritmo importante) e ocuparem até 1/4 de página. Excertos de código maiores devem ser colocados em anexo (mas sempre referidos e explicados no texto; se não forem referidos ou explicados no texto, não vale a pena estarem no documento);

* Após a compilação que consideram como sendo a final, façam uma pesquisa no pdf por ! (ponto de exclamação) e ? (ponto de interrogação) para encontrarem eventuais problemas de referências falhadas. Corrijam-nas se necessário.

### _Extended Abstract_

As dissertações escritas **em inglês** devem ter um _Extended Abstract_.
A fórmula para o _Extended Abstract_ é mais ou menos a seguinte:
* Traduzir **quase** na integra o capítulo 1 e as suas secções (exceto a última, que descreve a _organização do documento_);
* Incluir de seguida um resumo de cada um dos capítulos (dois ou três parágrafos por capítulo).

Assim, as secções a incluir são, aproximadamente:
* Introdução;
* Enquadramento, Descrição do Problema e Objetivos;
* Principais Contribuições;
* Estado da Arte e Tecnologias Utilizadas;
* ...
* Trabalho Futuro.
Pode ter entre quatro a seis páginas.

## Dicas para a Apresentação e Defesa

### Formato
Relativamente ao formato da defesa, esta é dividida nas seguintes partes:

* 15 ou 20 minutos de apresentação do(a) candidato(a);
* 30 a 40 minutos para o(a) arguente (sessão tipicamente interativa com o arguente);
* 10 minutos para o orientador;
* 10 minutos para o presidente da mesa.

### Preparação
Relativamente à apresentação:

1. Sugiro começar por dar uma saudação (e.g., Boa tarde, (...)), apresentarem-se (e.g., o meu nome é (...)), referirem ao que vieram (e.g., e vou apresentar o trabalho de dissertação intitulado "TITULO" (...)) cumprimentar o júri (e.g., antes de prosseguir gostava de cumprimentar o júri, nomeadamente o Professor Doutor nome-do-arguente, o Professor Doutor Pedro Almeida e o Professor Pedro Inácio), e cumprimentar a audiência, se houver;

2. Tentem ocupar não menos do que 18 minutos e não mais do que 20 minutos. Menos do que 18 minutos parece sugerir que o trabalho não foi suficiente para uma apresentação mais elaborada; mais do que 20 é quebrar regras, e não deve acontecer;

3. Sugiro que treinem a apresentação muitas vezes em casa usando vocabulário diverso em cada diapositivo. I.e., de cada vez que fizerem a apresentação, tentem (forcem mesmo) que as palavras sejam diferentes. Isto vai-vos ajudar a ter sempre uma palavra disponível caso o vosso cérebro decida parar por alguns momentos;

4. Sugiro que treinem uma vez a apresentação no sentido inverso (i.e., do último diapositivo para o primeiro), para aumentar o domínio de todo o fluxo;

5. Terminem com algo semelhante a "Bem haja. Coloco-me agora à disposição para responder às questões."

6. Evitem animações, a não ser que se sintam muito muito à vontade. Normalmente, uma apresentação simples funciona bem e livra-vos de preocupações e cliques no rato adicionais;

7. Os diapositivos não devem ter demasiado texto, mas é sempre necessária uma frase ou keywords que guiem o júri em todos eles. Não devem colocar um diapositivo só com uma figura (adicionem-lhe, neste caso, uma breve descrição);

8. Devem tentar transmitir detalhes de trabalho que desenvolveram. Não se esqueçam de enfatizar esses detalhes. Devem ser ditas frases semelhantes a "Durante este trabalho de mestrado desenvolvi (...)" ou "Durante este trabalho de mestrado foi feito (...)" ou "Estudou-se, no contexto deste mestrado (...)";

9. Notem que devem ir mais cedo (entre 15 a 30 minutos) para a sala de reuniões ligar cabos e testar o projetor. Não arrisquem;

10. :warning: Atenção: **não pode haver erros ortográficos** numa apresentação deste calibre;

11. O conjunto de diapositivos pode ser escrito em Inglês, e a apresentação pode ser feita em Português.

### Estrutura da Apresentação
Relativamente à organização da apresentação, deixo apenas uma sugestão, que podem adaptar ao vosso caso:

1. Diapositivo de título com Titulo-da-Dissertação, seguido do texto "Dissertação submetida para obtenção do grau de mestre em Engenharia Informática na Universidade da Beira Interior", seguido do nome do autor, seguido do nome do orientador, seguido de "Covilhã, ANO";

2. Diapositivo com índice (chamado *Contents*);

3. Diapositivo com motivação/problema e objetivos do trabalho (Problem and Objectives);

4. Diapositivo com a abordagem tomada *(Adopted Approach for Solving the Problem)*;

5. Diapositivo com trabalho relacionado ou tecnologias importantes *(Related Work or Technology)*;

6. Diapositivos referentes ao desenvolvimento do trabalho;

7. Diapositivos com discussão de resultados ou demonstração de protótipo;

8. Diapositivo com as conclusões principais *(Main Conclusions)*;

9. Diapositivo com trabalho futuro *(Future Work)*;

10. Diapositivo com um texto semelhante a *"Thank you for your attention. Questions?"*

### Postura e Dress Code
Relativamente à postura:

* Sugiro que venham vestidos(as) de forma minimamente formal (o que tipicamente se chama de business casual);

* Devem treinar a apresentação de modo a que olhem para o júri enquanto a fazem;

* É boa ideia **trazer o relatório/dissertação para a defesa, e tê-la aberta em cima da mesa** (se o arguente fizer uma pergunta e indicar o número de página ou título de secção, devem tentar imediatamente ir até ao mesmo local na dissertação - demonstrem atenção e interesse);

* Sugiro que tragam uma caneta e bloco de notas ou folhas para tomarem apontamentos (se o arguente, o presidente da mesa ou o orientador derem sugestões, apontem tudo - demonstrem atenção e interesse);

* **Tenham uma atitude positiva. Nunca respondam a uma questão começando com a palavra "Não"** (mesmo que o arguente não tenha razão). Absorvam pancada que nem um saco de boxe muito esponjoso. Caso não concordem, deem a vossa opinião de forma positiva. Podem começar algumas dessas respostas com "Compreendo o que quer dizer, mas ...";

* Por vezes, há um nervoso miúdo (ou graúdo) a acompanhar o(a) candidato. Faz parte, e impede que se deixem dormir naquela hora.