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 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:
(Aguardando outros tópicos)
Referências