Code API reference¶
External documentation is not the place where to maintain code API reference. Code should be self-documented.
It doesn’t mean documentation cannot deal with API: it is a suitable place to provide tutorials or recipes, to focus on topics or workflows... It means that external documentation is not intended to replace inline code documentation.