Intruções para revisão

Seu objetivo como um revisor de artefato consiste em garantir que a qualidade do artefato corresponda com o conteúdo do artigo e os requisitos mínimos esperados para a obtenção de cada selo. Para realizar esta atividade com excelência, antes de avaliar os artefatos (i) leia o artigo; e (ii) defina as principais contribuições do trabalho. Estas duas etapas tornam o processo de avaliação de cada selo mais simples.

Note Observe que o período de revisão é relativamente curto. Recomendamos iniciar suas revisões assim que receber sua tarefa.

Passos para a avaliação de um artefato

O processo de revisão pode ser realizado em um ambiente de sua preferência, desde que bata os requisitos mínimos do ambiente de execução esperado para o artefato. Recomendamos a execução dos artefatos (quando aplicável) em um ambiente virtual por trazer praticidade para os revisores e garantir que componentes presentes na sua máquina local não prejudiquem o processo de avaliação (um clean install em um ambiente novo pode reduzir imprevistos).

Caso recursos adicionais sejam necessários (infraestrutura de nuvem, chaves SSH, etc.) estas informações devem estar presentes no apêndice do artefato.

Os artefatos em avaliação já são artigos aceitos pelo comitê técnico do WGRS'24. Desta forma, não há necessidade de avaliar sua solidez científica. No entanto, caso você encontre algum problema, relate entrando em contato com os coordenadores de avaliação de artefatos.

Note Lembre-se de que todos os artefatos, análises e discussões são confidenciais

Processo de Revisão

O processo de revisão está dividido em duas etapas. Primeiramente, você como revisor deve selecionar os trabalhos que possuem afeição/familiaridade com o assunto para o posterior processo de revisão. Faça a escolha de trabalhos o quanto antes para que o comitê tenha conhecimento das revisões de cada membro. Os trabalhos estão presentes em uma planilha online, cada membro do CTA e do CTAA irá escolher 3 ou mais trabalhos para avaliar.

Após ter selecionado seus trabalhos, você já pode começar a realizar as revisões. Para orientar esta segunda etapa, um conjunto de instruções com pontos chaves do processo de avaliação de artefato foi definido pelo comitê. As instruções definindo os requisitos para a obtenção de cada selo.

Para que o trabalho/artefato seja apto a receber o selo, os respectivos requisitos devem ser alcançados:

Artefatos Disponíveis (SeloD)

É esperado que o código e/ou dados estejam disponíveis em um repositório estável (como GitHub e GitLab). Neste repositório é esperado encontrar um README.md com uma documentação mínima descrevendo o objetivo do artefato, com o respectivo título e resumo do artigo.

Artefatos Funcionais (SeloF)

É esperado que o código e/ou artefato possa ser executado e o revisor consiga observar algumas de suas funcionalidades. Para adquirir este artefato, é importante que informações adicionais estejam presentes no README.md do repositório, como

  1. lista de dependências;
  2. lista de versões das dependências/linguagens/ambiente;
  3. descrição do ambiente de execução;
  4. instruções de instalação e execução;
  5. um exemplo de execução mínima.

Artefatos Sustentáveis (SeloS)

É esperado que o código e/ou artefato esteja modularizado, organizado, inteligível e de fácil compreensão. Para obter o selo é interessante que:

  1. exista uma documentação mínima do código (descrevendo arquivos, funções,..);
  2. legibilidade mínima de código;
  3. permita que os avaliadores consigam identificar as principais reivindicações do artigo no artefato.

Experimentos Reprodutíveis (SeloR)

É esperado que o revisor consiga reproduzir as principais reivindicações apresentadas no artigo. Para obter este selo é esperado:

  1. instrução para executar as principais reivindicações (e.g., resultados dos principais gráficos/tabelas);
  2. descrição de um processo de como foram executados os experimentos para chegar até o resultado do artigo;
  3. descrição de detalhes técnicos específicos do ambiente (quando aplicável). Por exemplo, incluir detalhes da infraestrutura utilizada na Amazon Cloud ou Google Cloud. Eventualmente, incluir até chaves de acesso para permitir a reprodução do experimento.

Entrega das Revisões

Para cada artefato, você deve produzir uma breve revisão justificando a razão por atribuir ou negar um selo ao artefato. Esta avaliação só deve ser completada após o processo de avaliação tenha sido realizado.

Para facilitar o processo de avaliação, complete os comentários para cada selo seguindo o seguinte modelo que levam em consideração os critérios necessários para receber cada selo.

Exemplos:

(caso 1, selo atribuido) SeloD: Artefato publicamente Disponível (comentários)
+ disponíveis em um repositório estável
+ documentação mínima
+ título
+ resumo
Recomendo a atribuição do selo.

(caso 2, selo não atribuido) SeloD: Artefato publicamente Disponível (comentários)
+ disponíveis em um repositório estável
- documentação mínima
+ título
- resumo
Não posso recomendar a atribuição do selo, por não  possuir uma documentação mínima e resumo do artigo.

(caso 3, CASO O SELO NÃO TENHA SIDO SOLICITADO) SeloD: Artefato publicamente Disponível (comentários)
O selo não foi solicitado para esta categoria.

Utilize dos sinais (-) e (+) para demonstrar qual dos critérios o artefato não esteja alcançando (caso utilize o sinal de -) ou esteja alcançando (caso utilize o sinal de +). Também é importante ressaltar a conclusão da revisão, explanando as motivações quando o artefato não alcança os critérios mínimos esperados para cada selo.

Note Imagine que a seção de comentário deve ser tratada como se fosse uma seção de comentários para os autores em um processo de revisão onde o feedback seria apresentado para os autores em uma fase posterior.