Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Create a script that finds inconsistencies between the input arguments of a function and the docstrings #11

Open
jcohenadad opened this issue Jun 18, 2020 · 0 comments

Comments

@jcohenadad
Copy link
Member

Context

Currently, the documentation is semi-manually maintained: we need to manually write each input argument so they appear in the documentation.

Problem

  • someone adds an argument and forgets to expose it in the docs
  • someone removes an argument and forgets to remove it in the docs

Potential solution

A function that would compare the input arguments of each function/class and the exposed arguments in the docstrings, and raise a warning if there is a mismatch. This function would be called by the crawler that goes through all the files/functions of the project.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant