Thursday, December 9, 2021
1 change · master
Enhancements to existing features
This update cleans up inaccurate or broken internal developer documentation in Odoo core and the Base module, and adds automated checks to prevent similar issues from being introduced later. It helps maintain code quality and reduces confusion for teams working on the platform, with no expected direct impact on end users.
Original PR description
Lots of docstrings are wrong in the details with invalid rST, documenting parameters which don't exist (anymore), *not* documenting parameters which do, fucking up info fields, specifying types incorrectly, ... This PR is a stab at fixing some of those issues and trying to make things last a bit, by enabling a checker to try and prevent broken docstrings from being committed. Note that the checker is currently configured to only check the core (odoo and the `base` module): this is already a fair amount of changes, so to avoid Extreme Conflicts I think it'd be a good idea to get that merged, then start expanding the scope of the checker.