> For the complete documentation index, see [llms.txt](https://guias.mosaico.gov.pt/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guias.mosaico.gov.pt/guias-praticos/como-disponibilizar-e-reutilizar-dados-abertos/findability-tornar-os-dados-localizaveis.md).

# Findability – Tornar os dados localizáveis

## Descrever os dados com metadados

Fazer a descrição dos dados ao recorrer a [metadados](https://mosaico.gov.pt/glossario#glossario-metadados) completos e atualizados, que incluam toda a informação relevante para permitir que sejam descobertos e utilizados com maior facilidade; ter em conta que quanto mais informação for fornecida sobre os dados, mais fácil será para os utilizadores encontrá-los, o que aumenta as hipóteses de serem reutilizados.

Os metadados devem ser precisos, exatos e úteis, com vista a ajudar os utilizadores a identificar se a informação disponibilizada corresponde ao que pretendem, e incluir:

* Título
* Descrição
* Palavras-chave
* Categorias
* [Informação temporal](https://mosaico.gov.pt/glossario#glossario-informacao-temporal)
* [Informação espacial](https://mosaico.gov.pt/glossario#glossario-informacao-espacial)

De seguida são ilustrados dois exemplos da descrição de dois conjuntos de dados, um correto e outro incorreto.

Neste exemplo correto a descrição do conjunto de dados está bem detalhada, o que ajuda os potenciais utilizadores a terem uma visão geral do seu conteúdo.

<figure><img src="https://2869735785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0oDmFsd3xf4yMMXZ1ctr%2Fuploads%2FqpfdxMONBEB1BZbTX2cM%2FCard%20Extra%20Info.png?alt=media&amp;token=ae784251-7724-4a45-b18d-5f39747284fb" alt=""><figcaption><p>Exemplo correto da descrição de um conjunto de dados</p></figcaption></figure>

No exemplo incorreto abaixo a descrição do conjunto de dados é igual ao título e não fornece qualquer informação que seja útil para os utilizadores perceberem qual o seu conteúdo.

<figure><img src="https://2869735785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0oDmFsd3xf4yMMXZ1ctr%2Fuploads%2FA5dh6Z2x2E1not7Mx6mL%2FCard%20Extra%20Info-1.png?alt=media&amp;token=1fd13d9c-d47e-4673-a920-fe36547411ee" alt=""><figcaption><p>Exemplo incorreto da descrição de um conjunto de dados</p></figcaption></figure>

## Marcar valores não existentes como nulos

Marcar os valores em falta como valores nulos, de modo a não criar ambiguidade e indicar aos utilizadores que os dados não foram esquecidos. Ter em conta que se existir uma percentagem elevada de valores nulos numa linha ou coluna, deve-se considerar a sua eliminação, uma vez que estes registos provavelmente não irão trazer qualquer valor acrescentado aos utilizadores.

* Os valores em falta devem ser assinalados com “null” ou “NA”

De seguida são ilustrados dois exemplos de uma tabela [CSV](https://mosaico.gov.pt/glossario#glossario-csv) com dados sobre as visitas a páginas de um site. No exemplo incorreto, os valores em falta são indicados ao deixar os campos vazios, o que os torna ambíguos e pode dar origem a erros no processamento de dados. No exemplo correto são mostrados os mesmos dados, mas com os valores em falta assinalados como “null”.

<figure><img src="https://2869735785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0oDmFsd3xf4yMMXZ1ctr%2Fuploads%2FyZ0ZftcXoYeiuSqH8ftq%2FRight.png?alt=media&amp;token=4f073e89-33ee-4df5-ae30-392e06a0f524" alt=""><figcaption><p>Exemplo incorreto à esquerda, exemplo correto à direita, de como marcar valores não existentes como nulos</p></figcaption></figure>