How to use this guide

We designed this guide to be read from beginning to end, so that each section builds on the foundations of those that came before. If this is your first time reading the guide, we would encourage you to read it in this way. However, those looking for guidance on specific aspects of data visualisation can make use of the search and navigation functions of this website.

If you would prefer to read offline, you can download the guide as a PDF. Individual sections of the guide can also be downloaded as separate PDFs using the “Other Formats > PDF” option when shown in the right-hand navigation menu.

Throughout the text you will find examples of charts and graphs. For many of these, we provide code in R to allow you to reproduce the visualisations, and we encourage you to do so and to adapt the code for your own purposes.

How to contribute to this guide

To make a suggestion or ask a question

Please open up a discussion in our GitHub repository’s Discussions section.

If you spot a bug or an error

Please either:

  1. Raise an issue in our GitHub repository’s Issues section. You can do this using one of the ‘Report an issue’ links on our website; or
  2. Fork our repository, edit the relevant file(s), and make a pull request against the main branch of our repository. You can do this using one of the ‘Edit this page’ links on our website.

If you want to add a new feature or section to the guide

  1. Raise an issue in our GitHub repository’s Issues section, tag it as an ‘enhancement’ and describe your proposed contribution.
  2. Fork the repository and create a new branch named, e.g., my-new-feature-or-section.
  3. Add content, code and files to your branch.
  4. Make a pull request against the main branch of our repository.

Further information about the contribution process can be found in our repository’s README file.

How to engage with other users of this guide

Readers are encouraged to make full use of our GitHub repository’s Discussions section. Please note that use of, and all contributions to, our website and repository are governed by our Code of Conduct.