# Docstring style#

Docstrings should follow the numpy docstring guide. Read more about it Docstring formatting and type hints. In ArviZ docs, docstrings consit of five main sections, i.e.,

1. Short summary

2. Parameters

3. Returns

5. Examples Extended summary is strongly encouraged and references is required when relevant in order to cite the papers proposing or explaining the algorithms that are implemented. All other sections can also be used when convenient.

## References#

While adding description of parameters, examples, etc, it is important to add references to external libraries and ArviZ. Docstrings follow the same guide for adding references as the other docs. For adding references to external libraries functions and objects, see Reference external libraries. For referencing ArviZ objects, follow Referencing ArviZ objects.

For example, let’s add hdi() and plot_ppc() in the See Also section.
    See Also

All the kwargs parameters in plots modules are passed to the matplotlib or bokeh functions. While writing their description, the functions to which they are being passed must be mentioned. In order to check or add those functions, the process is the same for all the kwargs arguments. Let’s read the step-by-step guide for backend_kwargs as an example, here.