Tempo de leitura estimado : 4 min · Publicado
Comece a partir de casos de uso
Agrupe recursos por tarefa ou pergunta e use o tipo de documento somente quando ele ajudar na seleção. Alguém que planeja um projeto pode buscar uma lista de verificação em vez de um “papel branco”. Mantenha o número de categorias pequenas o suficiente para entender.
Evite colocar cópias separadas do mesmo arquivo em várias seções. Vincule uma entrada de origem das categorias relevantes. Os Guia de Operações de Conteúdo Ajuda a atribuir um proprietário e o ciclo de revisão.
- As categorias refletem as necessidades.
- Uma entrada de origem por recurso.
- Proprietário editorial conhecido.
Explique antes do download
Cada recurso precisa de um título preciso, resumo, público, formato, tamanho do arquivo e data da versão quando ele muda. Mostre uma breve prévia ou tópicos-chave para um arquivo longo. A redação do link deve anunciar claramente o que abre.
Os Guia de documentos acessíveis Abrange estrutura, links e formatos. Uma página HTML resumindo fatos essenciais também ajuda pessoas incapazes de abrir o arquivo.
- Formato e tamanho indicados.
- Resumo útil antes de abrir.
- Fatos essenciais disponíveis em HTML.
Testes e filtros de teste
Se o volume lhes garantir, ofereça uma busca tolerante a palavras comuns e alguns filtros confiáveis. Mostrar contagem de resultados, critérios ativos e um estado sem resultados que ajuda as pessoas a reiniciar. Uma lista curta não precisa de uma interface de filtro complexa.
Teste a navegação do teclado, o layout do telefone e os títulos longos. Os Guia de filtros Mostra como evitar combinações desnecessárias.
- A pesquisa se encaixa no volume.
- Os filtros usam dados confiáveis.
- Estado sem resultados explicado.
Mantenha as versões atuais
Indique quem analisa o conteúdo e quando deve ser substituído. Para uma nova versão, atualize a entrada, o arquivo, o compartilhamento de links e as versões traduzidas. Um recurso mais antigo pode permanecer disponível se seu status for explícito.
Verifique os downloads e documentos quebrados, citando regras ou números desatualizados regularmente. Remover um arquivo sem reparar os links recebidos deixa a biblioteca incompleta.
Exemplo fictício de biblioteca: quatro edições representam dois recursos lógicos, REF-7 e REF-8. Só uma edição é simultaneamente atual e aprovada nestes dados. REF-7 continua em v1 em inglês, enquanto o francês já está em v2: indique o desfasamento, a língua disponível e a alternativa escolhida. Não apresente as quatro linhas como quatro recursos atualizados nem a tradução antiga como equivalente à edição atual.
Mantenha uma ficha de referência por recurso e associe-lhe edições, línguas e ligações de substituição. Distinga a data de publicação, a data de entrada em vigor quando aplicável e a data de revisão editorial. Alterar uma data não demonstra uma revisão do conteúdo. As recomendações W3C sobre versões de dados oferecem uma referência de rastreabilidade; aplicá-las a esta biblioteca documental é uma opção editorial a adaptar ao material.
- Versão e status visível.
- Cópias do idioma alinhadas.
- Links e fatos revisados regularmente.
Desloque a tabela horizontalmente para ler todas as colunas. Com o teclado, coloque o foco na tabela e utilize as teclas de seta.
| Recurso e língua | Edição e estado | Tratamento na biblioteca |
|---|---|---|
| REF-7 · FR | v2 · atual e aprovada | Edição HTML principal |
| REF-7 · EN | v1 · tradução anterior | Desfasamento indicado; revisão de v2 pendente |
| REF-7 · FR | v1 · arquivo | Estado visível e ligação para v2 |
| REF-8 · FR | v0 · rascunho | Fora da lista pública até aprovação |
- W3C : Data Versioning
W3C, consultado em 22 de outubro de 2026: indicadores e histórico de versões de dados. Os identificadores e estados são fictícios.
Documentos de referência
- W3C : Dados na Web práticas recomendadas · Fonte consultada
Conteúdo atualizado
