Adiciona contribuição dos autores

[gustavofonseca]

O que esse PR faz?

Adiciona documentação narrativa sobre a representação de informação sobre contribuição dos autores de acordo com a taxonomia CrediT. O texto foi baseado na recomendação da JATS4R disponível em https://jats4r.org/credit-taxonomy

Onde a revisão poderia começar?

O texto está sendo trabalhado em https://docs.google.com/document/d/1UwHgZc-99cnRlg5lfbLMPAbfWmDLmgMYY1fxgdh9ScI/edit?usp=sharing

Algum cenário de contexto que queira dar?

n/a

Screenshots

n/a

Quais são tickets relevantes?

821

Referências

• JATS4R CRediT Taxonomy Guidelines: https://jats4r.org/credit-taxonomy
• NISO JATS 1.1: http://jats.nlm.nih.gov/publishing/tag-library/1.1/
• CASRAI Contributor Roles: https://dictionary.casrai.org/Contributor_Roles
• CRediT: Contributor Role Taxonomy - Going beyond authorship: https://docs.google.com/document/d/1aJxrQXYHW5U6By3KEAHrx1Iho6ioeh3ohNsRMwsoGPM

[gustavofonseca]

Penso que seria bacana incluirmos a definição de CrediT no glossário, o que vocês acham?

[cinthia-vieira]

Penso que seria bacana incluirmos a definição de CrediT no glossário, o que vocês acham?

Boa :)!!

[RPostalli]

@gustavofonseca já fiz essa solicitação, só falta criar os textos. Veja https://github.com/scieloorg/scielo_publishing_schema/issues/879

[gustavofonseca]

Não sei se isso já foi discutido/decidido, mas seria interessante referenciar esta documentação em <role> e <contrib> :)

Vou fazer isso.

[gustavofonseca]

Não sei se isso já foi discutido/decidido, mas seria interessante referenciar esta documentação em <role> e <contrib> :)

@cinthia-vieira e @RPostalli, fiz as alterações. Peço que revisem novamente por gentileza.

[gustavofonseca]

@gustavofonseca sugestões:

* Em contrib, deixar a frase "Recomenda-se o uso da taxo..." em Note, junto com as outras notas similares.

Posso fazer isso, mas considero que o texto fica empobrecido com esse uso excessivo de Note.

* Em role não ficou claro que o uso da taxonomia é exclusivo para role em contrib e não deve ser usado em element-citation. Sugiro inserir uma nota ao final da documentação ou informar no texto inicial.

Mas não há tal exclusividade. Se <role> é aceito dentro de <element-citation> então nada impede que seja utilizada a taxonomia.

[RPostalli]

@gustavofonseca

Sobre: Posso fazer isso, mas considero que o texto fica empobrecido com esse uso excessivo de Note.

Tornou-se um padrão o uso de Note para esse tipo de informação, é estranho que algumas informações estejam em notas e outras não, sendo que elas possuem exatamente o mesmo intuito. O empobrecimento acredito que é uma visão sua, mas não é para os usuários nem para a equipe de produção. Essas notas não são excessivas, pelo menos não para nós. Mas fica a seu critério, foi só uma sugestão.

Sobre: Mas não há tal exclusividade. Se é aceito dentro de então nada impede que seja utilizada a taxonomia.

Isso muda as ferramentarias inclusive markup, a Roberta não estava prevendo a inserção de role com Credit em element-citation (ou estava @robertatakenaka). Siga com a documentação como está mas sugiro replicar os tickets nos repositórios pertinentes (considerando web já que o role deverá ficar como hiperlink)