This is a template recipe. A recipe should be a complete description of a given task [1]. An example could be how to make an all-sky image.
A recipe should always start with an introduction describing briefly what the recipe is for and a rough sketch of the approach. The rest of the recipe can be divided into
The recipe may have an appendix.
You can make inline references to Python modules, classes, methods and functions using the cross referencing directives as described in Documenting your code. There you will also find how to include math and images.
To nicely refer to other documents you may use the .. seealso:: directive.
See also
For more information about markup see Documenting your code
Footnotes
[1] | Note that this may or may not correspond to an actual Task. These should always be documented in the module source code and not in a recipe. |