Tutorial

Criando uma nova configuração

Requisitos

Para criar uma configuração, é necessário:

<%= link_to(t('signed_up'), new_user_registration_path) %> na plataforma
Estar <%= link_to(t('signed_in'), new_user_session_path) %>
Já ter criado pelo menos um Grupo de Leitura

Introdução

Para processar um repositório, o Mezuro utiliza configurações que você especifica no <%= link_to(t('repository_creation'), tutorials_path('analyzing')) %>.

Componentes de Configuração

Aqui você será apresentado brevemente a todos os componentes de uma configuração e, em seguida, verá os passos para criar uma nova configuração.

Configuração

Apenas um contêiner de alto nível para a associação componentes restantes

Métricas

Especificação de quais métricas serão calculadas durante o processamento e como interpretar seus resultados

Peso: para cada módulo é dada uma nota, que é uma média ponderada de todas as métricas calculadas para ele. Este campo corresponde ao peso da métrica sobre a nota final
Forma de Agregação: Nem todas as métricas podem ser calculadas para cada módulo. Para este tipo de métrica, calcula-se a agregação dos valores de acordo com o que está especificado em cada campo
Grupo de Leitura: especifica qual conjunto de interpretações (chamados leituras) estará disponível para esta métrica

Grupo de Leitura

Apenas um contêiner de alto nível para as leituras (interpretações)

Leitura

Leitura: a interpretação de um determinado valor fornecendo rótulo, nota (esta é a nota utilizada para a média ponderada mencionada acima) e a cor

Intervalo

Associa intervalos numéricos para as leituras de uma determinada métrica

Passos

Criando Configuração
1. Clique em "Configuração" no menu superior
2. Clique em "Nova Configuração"
  1. Preencha o formulário com um "Nome", que deve ser único
  2. Preencha o formulário com uma "Descrição"
3. Clique em "Salvar" e você será redirecionado para a página de configuração
Adicionando uma Métrica
1. A partir da página de configuração
2. Clique em "Adicionar Métrica"
3. Selecione um coletor das opções e clique na métrica que você deseja adicionar
  1. Preencha o formulário com um "Peso" que será utilizado para o cálculo da nota final
  2. Escolher a "Forma de Agregação" que irá ser utilizada para esta métrica
  3. Selecione o "Grupo de Leitura", que irá fornecer as interpretações para essa métrica
4. Clique em "Salvar" e você deve estar na página de configuração, agora com uma nova métrica adicionada
Criação de Intervalos
1. A partir da página de configuração
2. Clique em "Mostrar" para a métrica que você deseja criar intervalos
3. Clique em "Adicionar intervalo"
  1. Preencha o formulário com os valores de "Início" e "Fim" de cada intervalo
  2. Preencha o formulário com os "Comentários", que serão exibidos se o valor da métrica corresponder ao intervalo
  3. Selecione a "Leitura" que será associada a este intervalo
4. Clique em "Salvar" e você deve estar na página da métrica com o novo intervalo criado, parabéns!