Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Validação de contrib/role (tipo de contribuição na pesquisa) #376

Closed
4 tasks done
robertatakenaka opened this issue Feb 16, 2023 · 0 comments
Closed
4 tasks done

Comments

@robertatakenaka
Copy link
Member

robertatakenaka commented Feb 16, 2023

Descrição da nova funcionalidade

Como analista de qualidade, eu quero que o elemento contrib/role seja obrigatório, seu conteúdo e seu atributo @content-type contenham os valores esperados para que os artigos expressem as práticas de Ciência Aberta.

Por valores esperados, para @content-type é um URI válido definido pelo CReDiT e, para o conteúdo de role, o valor correspondente a URI.

Exemplo de artigo que considera a taxonomia Credit, mas não contém marcação dos links em @content-type: https://www.scielo.br/j/ramb/a/5N7yNNHYxNpCZ6jrKdfkQZK/?format=xml

Captura de Tela 2023-02-16 às 08 48 07

Padrão esperado

<contrib contrib-type="author">
<role content-type="https://credit.niso.org/contributor-roles/conceptualization/">Conceptualization</role>
<role content-type="https://credit.niso.org/contributor-roles/data-curation/">Data curation</role>
<role content-type="https://credit.niso.org/contributor-roles/formal-analysis/">Formal Analysis</role>
<role content-type="https://credit.niso.org/contributor-roles/writing-original-draft/">Writing &#x2013; original draft</role>
</contrib>

<contrib contrib-type="author">
<contrib-id contrib-id-type="orcid">0000-0003-3657-3620</contrib-id>
<name><surname>Di&#x15F;&#xE7;i</surname><given-names>Esra</given-names></name> <xref ref-type="aff" rid="aff2"><sup>2</sup></xref>
<role content-type="https://credit.niso.org/contributor-roles/conceptualization/">Conceptualization</role>
<role content-type="https://credit.niso.org/contributor-roles/data-curation/">Data curation</role>
<role content-type="https://credit.niso.org/contributor-roles/project-administration/">Project administration</role>
<role content-type="https://credit.niso.org/contributor-roles/supervision/">Supervision</role>
<role content-type="https://credit.niso.org/contributor-roles/writing-original-draft/">Writing &#x2013; original draft</role>
<role content-type="https://credit.niso.org/contributor-roles/writing-review-editing/">Writing &#x2013; review &#x26; editing</role>
</contrib>
<contrib contrib-type="author">
<contrib-id contrib-id-type="orcid">0000-0003-4658-5254</contrib-id>
<name><surname>Peks&#xF6;z</surname><given-names>R&#x131;fat</given-names></name> <xref ref-type="aff" rid="aff2"><sup>2</sup></xref>
<role>Resources</role>
<role>Formal analysis</role>
</contrib>
<contrib contrib-type="author">
<contrib-id contrib-id-type="orcid">0000-0002-7746-2700</contrib-id>
<name><surname>&#xD6;zt&#xFC;rk</surname><given-names>Nurinnisa</given-names></name> <xref ref-type="aff" rid="aff3"><sup>3</sup></xref>
<role content-type="https://credit.niso.org/contributor-roles/resources/">Resources</role>
<role content-type="https://credit.niso.org/contributor-roles/formal-analysis/">Formal Analysis</role>
</contrib>
<contrib contrib-type="author">
<contrib-id contrib-id-type="orcid">0000-0003-1869-6010</contrib-id>
<name><surname>Yildirgan</surname><given-names>Mehmet &#x130;lhan</given-names></name> <xref ref-type="aff" rid="aff2"><sup>2</sup></xref>
<role content-type="https://credit.niso.org/contributor-roles/project-administration/">Project administration</role>
<role content-type="https://credit.niso.org/contributor-roles/supervision/">Supervision</role>
<role content-type="https://credit.niso.org/contributor-roles/writing-review-editing/">Writing &#x2013; review &#x26; editing</role>
</contrib>
</contrib>
<contrib contrib-type="author">
<contrib-id contrib-id-type="orcid">0000-0002-2535-4329</contrib-id>
<name><surname>Albayrak</surname><given-names>Yavuz</given-names></name> <xref ref-type="aff" rid="aff2"><sup>2</sup></xref>
<role content-type="https://credit.niso.org/contributor-roles/conceptualization/">Conceptualization</role>
<role content-type="https://credit.niso.org/contributor-roles/formal-analysis/">Formal Analysis</role>
</contrib>

Referências

Depende de #386
https://jats4r.org/credit-taxonomy#table-1-credit-terms-and-urls
Esta estória é reescrita de #326

Considerações

Os produtos de XML são capazes de marcar os elementos de XML apenas do conteúdo existente no texto. Eles não devem criar texto que não existe.
A ausência de marcação / identificação dos elementos é devido a ausência inerente do documento original.
Os termos marcados podem não estar em inglês conforme o CReDiT. Sendo assim, pode ser difícil de verificar se o texto e a URI estão correspondentes.
Outro desafio é que as URIs podem mudar no decorrer tempo por manutenção das regras.

Critérios de aceitação

  • O resultado da validação deve informar ausência de contrib/role e contrib/role/@content-type
  • A função de validação deve ser informada uma lista de pares de URI e texto correspondente em inglês
  • A função deve validar se o valor de role/@content-type corresponde a alguma URI fornecida
  • A função deve validar se o valor de role corresponde ao texto inglês associado com a URI. Caso não corresponda, informa o texto encontrado no XML e o texto esperado. O usuário da validação fará a avaliação a partir daí.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Development

No branches or pull requests

3 participants