Improve documentation generation, docstrings in style/interpolation code, add .darglint
A few smaller documentation improvements:
- Due to the removal of
sphinx_autodoc_typehints
, the arguments are not shown twice (once created by napoleon, once by this module). - new: https://joneuhauser.gitlab.io/-/extensions/-/jobs/1289864181/artifacts/build/sphinx/html/source/inkex.properties.html#inkex.properties.BaseStyleValue.factory
- old: https://joneuhauser.gitlab.io/-/extensions/-/jobs/1274341705/artifacts/build/sphinx/html/source/inkex.properties.html#inkex.properties.BaseStyleValue.factory
- Add config file for https://github.com/terrencepreilly/darglint which checks docstrings, especially listed args, exceptions and returns, for consistency. Not added to CI yet (not sure how much sense that makes)
- we now have a persistent
docs
folder, so no reason to keep a config file out of it and copying it everytime CI runs - improve docstrings and PEP8 the code I was working on recently: Styles, Tween, Properties