> For the complete documentation index, see [llms.txt](https://openup.gitbook.io/wazimap-ng/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://openup.gitbook.io/wazimap-ng/common-practices/general.md).

# General

## Sources

* Label data sources as `{{ dataset title }} - {{ organisation }}`so that users can more easily find the right data source.

![](/files/-MdIJ4IuWBt2UEOB4FAO)

* Link to the official page about the actual dataset, if one exists, otherwise to the homepage of the source organisation.
* Prefer writing source names in full, rather than abbreviated. e.g. `Our world in data` rather than `OWID`
* See if they have a preferred way to be cited and try to use that.

## Number formatting

### Percentage raw data

* Select Value as the default between Value/Percentage presentation in the chart/table
* Disable the Value/Percentage toggle

### Ratios

* Use `""` as the format string - as in - don't use the SI unit formatting, because then 0.789 will look like 789m and people will think it means millions.

### Decimals

If you're going to use format strings that format with SI units, **ensure you configure no more than 2 decimal places or 3 significant digits**, otherwise you could end up with numbers presented as `12.345k` and people will misread the . as a thousand separator due to the three decimal places and think this is `12 345 000`


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://openup.gitbook.io/wazimap-ng/common-practices/general.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.