Ampliação da documentação narrativa

[gustavofonseca]

O guia da SciELO PS é, em grande parte, uma descrição referencial dos elementos XML que podem ser utilizados na marcação do documento. Não há nada de errado nisso, mas a abordagem é insuficiente e apresenta uma barreira de entrada bastante acentuada.

Pense no guia da SciELO PS como um dicionário: um grande mapeamento de palavras (nomes de elementos) para suas definições. Se você deseja descrever um sentimento que não sabe o nome, o dicionário não oferece grande ajuda. O mesmo ocorre com o guia. Alguém que deseja saber as recomendações para a marcação das afiliações institucionais deverá buscar entre as descrições das dezenas de elementos.

Minha sugestão é que a parte narrativa da documentação seja ampliada e passe a contar com os tópicos:

• Autores e afiliações
• Histórico de datas
• Figuras e tabelas
• Fórmulas e equações matemáticas
• Permissões de uso
• Contribuições dos autores (taxonomia CRediT)

(Aguardando outros tópicos)

Referências

• O formato da JATS4R serve de inspiração: https://jats4r.org/recommendations-list