> 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/sanef-election-dashboard.md).

# SANEF election dashboard

## Formatting standards for display purposes

### Number of people

* Ensure any data pertaining to people are rounded to the nearest whole number.
* Do **not** use "M" and "k". Use full figures with thousands-separator.
* Examples:
  * data entry refers to `104678.9 people` --> this should be displayed as `104,679`.
  * data entry refers to `109987789.49 people` --> this should be displayed as `109,987,789`.

## Financial years

### Full values

Prefer full financial years, as in `2016-2017` rather than `2017` or `2016-17`. This is because

* Most people don't know that in the municipal sphere (unlike national) `2017` means `2016-2017`
* Many people won't realise that the -17 means the next year - writing it in full is much easier to understand correctly the first time.

### Subindicator ordering

Order financial years in subindicator groups in reverse chronological order - that is 2018-2019 and then 2017-2016. People are most often interested in the latest financial year.

### Non-aggregatable

Always mark the financial year column as non-aggregatable. Summing over financial years usually doesn't make sense for an abritrary number of financial years and can easily lead to surprises for users.

### Default filter

When the financial year column is not the variable, add a default filter to match the latest financial year. Marking financial year as non-aggregatable will already add a filter for it, but adding default filter configuration will ensure that a sensible value is selected in the filter.

## Age bands 

The reasoning for our preferred age bands is as follows:

* Ideally bands should align with voting age
* Ideally bands should align across datasets e.g. demographics should align with election data
* perhaps 0-18, 18-19, 20-29, 30-39, 40-49, 50-59, 60+

## Sources

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

![](/files/-MdIJ4IuWBt2UEOB4FAO)

as opposed to

![](/files/-MdIJP4XCcLM1m8jRSoQ)


---

# 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/sanef-election-dashboard.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.