\documentclass[a4paper, oneside, 10pt]{article}
\usepackage[unicode]{hyperref}
\usepackage[utf8x]{inputenc}
\usepackage[english]{babel}
\date{\today}
\title{}
\author{}
\begin{document}



\section{\texorpdfstring{Trabalho final}{Trabalho final}}
\label{sec:trabalho_final}


O trabalho final da disciplina é criar uma função e sua página de ajuda, no formato usado pelo R. Cada aluno abrirá uma página no \emph{wiki} para colocar seu trabalho. Caso ainda não tenha criado sua página, veja instruções em: . Sempre que desejar acessar sua página entre no menu lateral na sessão \textbf{Área Alunos} link Wiki Alunos.

\subsection{\texorpdfstring{O que é?}{O que e}}
\label{sec:o_que_e}

\begin{itemize}
  \item O trabalho final consiste em publicar em sua página o código da função, o arquivo da função, e a página de ajuda.
  \item A página de ajuda deve estar no formato do R (modelo disponível \href{media/bie5782/01_curso2009/material/modelo_help.txt}{aqui}).
  \item O código da função e o texto de ajuda devem estar formatados como código em sua página (use o \emph{flag} \texttt{\textless code\textgreater  ... \textless /code\textgreater }, veja a \href{http://ecor.ib.usp.br/doku.php?id=wiki:syntax\%23non-parsed_blocks}{seção de sintaxe do Dokuwiki}).
  \item Será que seu código é bom o suficiente? Veja \href{http://www.nature.com/news/2010/101013/full/467753a.html}{aqui}.
\end{itemize}


O que deve ter uma funcao 

\subsection{\texorpdfstring{Etapas}{Etapas}}
\label{sec:etapas}


\subsubsection{\texorpdfstring{Proposta}{Proposta}}
\label{sec:proposta}

\begin{enumerate}
  \item Poste em sua página um texto curto com sua proposta de trabalho final. 
  \item Prepare uma proposta alternativa (,,plano B"), e também coloque na sua página.
  \item A equipe de professores e monitores postará na sua página a avaliação de viabilidade de sua proposta, e também dicas e sugestões.
\end{enumerate}


\paragraph{\texorpdfstring{A PROPOSTA}{A PROPOSTA}}
\label{sec:a_proposta}


\emph{\textbf{\underline{Passos para uma boa proposta}}}

Uma boa proposta é um dos principais passos para um bom trabalho, não só nessa disciplina\footnote{no seu mestrado e doutorado tb,,}. Investir em uma boa descrição da função vai poupar trabalho posterior e ajuda a valorizar seu trabalho final. Nossa experiência demonstra que boas propostas normalmente levam a bons/ótimos trabalhos e que propostas mal planejadas derivam trabalhos medianos, em geral com maior esforço associado.   
Abaixo algumas dicas e sugestões para a sua proposta:
\begin{enumerate}
  \item descreva claramente a tarefa que a função irá realizar, independente do contexto particular;   
  \item evite iniciar a descrição da proposta com o seus dados e sua área de atuação, tente descrever a tarefa o mais independente possível do grupo taxonômico, área de atuação ou preferências religiosas ou sexuais! 

  \begin{itemize}
      \item \textbf{troque}: \emph{minha função ira tratar os dados da circunferência da barriga de coelhos da páscoa que coletei na semana santa e fazer um teste de permutação da diferença entre as médias do tamanho da pança de machos e fêmeas}
      \item \textbf{por}:\emph{ a função irá tratar dados de duas variáveis quantitativas e gerar um teste de permutação da diferença entre as médias das variáveis }
    \end{itemize}
  \item caso sinta necessidade de explicar melhor a tarefa descrita no primeiro tópico, exemplifique o uso da função no contexto do seu trabalho (finalmente!), de preferência apenas como \textbf{um dos usos} da função!
  \item  defina claramente os objetos e argumentos de entrada da função:

  \begin{itemize}
      \item \textbf{evite}: \emph{entra os dados da planilha que coletei em campo}
      \item \textbf{use}: \emph{um vetor numérico quantitivo, um dataframe com variáveis x e y, um argumento lógico de exclusão de NA, um argumento que define o tipo de índice que será calculado com as seguintes opções... }   
    \end{itemize}
  \item descreva claramente o objeto de saída e os gráficos gerados:

  \begin{itemize}
      \item \textbf{evite}: \emph{vai gerar um analise de dados e um gráfico bonito}
      \item \textbf{use}: \emph{ vai retornar um data-frame com as seguintes colunas..., uma lista com os seguintes resultados, um boxplot da variável y e um scatterplot de xy e a linha do modelo linear}
    \end{itemize}
  \item tente ser conciso, uma proposta muito longa dificulta a correção. Explicações específicas devem ser colocadas em linques externos. Caso tenha algum conceito importante e específico, crie um linque para uma fonte confiável.
  \item lembre-se: o R não faz mágica, se você não tem nenhum conhecimento sobre a tarefa que será executada pela sua função, vislumbramos dois caminhos: (1) aprender a fazer mágica; (2)  pagar alguém que conheça a tarefa que será executada e domine o R! Desaconselhamos a buscar ambas as saídas: a mágica, porque não acreditamos e o programador porque vai sair caro!
  \item Buque uma tarefa factível, mas que ao mesmo tempo seja \textbf{um desafio estimulante e que te tire da zona de conforto!} 
\end{enumerate}


\subsubsection{\texorpdfstring{Minha função}{Minha funao}}
\label{sec:minha_funao}

\begin{enumerate}
  \item invista em uma boa proposta,
  \item use o fórum para postar dúvidas,
  \item lembre-se: os monitores querem ajudá-lo,
  \item não acabe com a paciência dos professores,
  \item não esqueça: vc. irá sobreviver!
\end{enumerate}


\paragraph{\texorpdfstring{O Código}{O Codigo}}
\label{sec:o_codigo}


TODAS AS LINHAS DO CÓDIGO DEVEM POSSUIR COMENTÁRIOS EXPLICATIVOS! TODAS!! 

Os objetivos dessa exigência são:
\begin{enumerate}
  \item incentivá-los a cultivar o hábito saudável de sempre comentar seus códigos 
  \item ajudar os monitores e professores a entender o código de vocês. 
  \item ajudar futuros alunos que consultem suas funções a entender o código também. 
\end{enumerate}


A regra é clara: toda linha de código devem ter um comentário explicando o que a linha faz. 
Além disso, comentários gerais no começo ou no meio da função são bem vindos. A idéia é explicar cada passo da lógica da sua função. As únicas linhas de código que dispensam comentários são abre chaves e fecha chaves. 

No Fórum tem um exemplo de uma função bem simples com comentários em todas as linhas
\href{http://bie5782.138098.n3.nabble.com/Aviso-Importante-sobre-o-trabalho-final-td4026734.html}{Exemplo}

\paragraph{\texorpdfstring{A formatação do Trabalho Final}{A formataao do Trabalho Final}}
\label{sec:a_formataao_do_trabalho_final}


No inicio dessa página  Trabalho Final (\autoref{sec:Trabalho Final}) há uma indicação clara sobre o formato de postagem da função e do help. Isso ajuda muito na correção e permite que usuários vejam o código da função sem a necessidade de baixar o arquivo em seus computadores.

São exigências muito simples de formatação, qualquer dúvida poste no fórum, converse com um monitor ou veja página dos alunos de outros anos.

\subsection{\texorpdfstring{Prazos}{Prazos}}
\label{sec:prazos}


Os prazos foram mudados. Fique atento aos novos prazos.
\begin{itemize}
  \item Proposta (primeira versão): \textbf{01 de junho de 2017} 
  \item Revisão final da proposta pelos professores e monitores: \textbf{09 de junho de 2017}
  \item Produto final \textbf{25 de junho 2017}
\end{itemize}


\subsection{\texorpdfstring{Quanto vale minha função?}{Quanto vale minha funao}}
\label{sec:quanto_vale_minha_funao}


Não sabemos! Uma boa função pode ter um valor inestimável. Imagine que sua função busque e ordene páginas web a partir de palavra(as) chaves\footnote{antes do google, logicamente}? Valeria uma fortuna em 1995! No caso da disciplina, o trabalho final tem peso 7/10 na nota final, veja pesos da avaliação em  . 

\underline{\emph{\textbf{Pontos considerados na avaliação do trabalho final}}}
\begin{enumerate}
  \item a função roda o exemplo do help;
  \item a função cumpre a descrição da proposta acordada;
  \item há generalidade no seu uso;
  \item a documentação é adequada e informativa;
  \item demonstra domínio básico da linguagem;
  \item os comentários são informativos; 
  \item há redundâncias no código;
  \item complexidade da tarefa executada;
\end{enumerate}


\end{document}
