Openfisca-core

Documentation

- Complete the documentation of the commons module

Bug Fixes

- Fix doctests of the commons module

Dependencies

- `darglint`, `flake8-docstrings`, & `pylint`
- For automatic docstring linting & validation.

Technical changes

- Run openfisca-core & country/extension template tests systematically

Bug fix

- In _test_yaml.py_:
- Fix yaml tests loading —required for testing against the built version.

Non-technical changes

- Reorganise `Makefile` into context files (install, test, publish…)
- Colorise `make` tasks and improve messages printed to the user

New Features

- Introduce `openfisca_core.variables.typing`
- Documents the signature of formulas
- Note: as formulas are generated dynamically, documenting them is tricky

Bug Fixes

- Fix the official doc
- Corrects malformed docstrings
- Fix missing and/ou outdated references

Technical Changes

- Add tasks to automatically validate that changes do not break the documentation

Documentation

- Add steps to follow in case the documentation is broken
- Add general documenting guidelines in CONTRIBUTING.md