Never be included in a function file, instead it should be in a separate documentation source online

Be as short as possible to minimise file size

Explain what each line of code does inside the function

Have a docstring describing the inputs and outputs of a function, and comments throughout explaining why and how the code works