[Guidelines] Header

[pradal]

Provide an example of an header of a source file in an OpenAlea package

# -*- coding: latin-1 -*-

"""
    This script allows to run XXX over one scenario or a list of scenarios, using a specific set of parameters and
    options, which are specified in an input file.

    :copyright: see AUTHORS.
    :license: see LICENSE for details.
"""

or

#  -*- coding: utf-8 -*-

"""
    XXX.scenarios
    ~~~~~~~~~~~~~
    The module :mod:`XXX.scenarios` is the front-end to run the XXX model.

    :copyright: see AUTHORS.

    :license: see LICENSE for details.

"""