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

Support for docstrings #2

Open
julianLapenna12 opened this issue May 12, 2023 · 3 comments
Open

Support for docstrings #2

julianLapenna12 opened this issue May 12, 2023 · 3 comments
Labels
good first issue Good for newcomers

Comments

@julianLapenna12
Copy link

I'm considering using a tool similar to this, but I would need it to work to automatically scan docstrings... maybe something that works in tandem with PyDocStyle? I'm not quite sure

@johnsamuelwrites johnsamuelwrites added the good first issue Good for newcomers label May 15, 2023
@johnsamuelwrites
Copy link
Owner

@julianLapenna12 Thanks for creating this interesting issue. If I get this correctly, you would like to scan the code/programs using an extended version of PyDocStyle that includes inclusive that can indicate non-inclusive sentences in the code.

@julianLapenna12
Copy link
Author

Yes, it's not immediate and I'm also looking around for other libraries. But essentially on the larger scale, my team has been looking at a docstring linter that could detect words that are not inclusive and suggest replacements (i.e. abort would be flagged and suggested to be replaced with force quit).

@johnsamuelwrites
Copy link
Owner

This is an interesting use case: integration with docstring linter. inclusive is generic as well as configurable. New words in any language can be easily added to the list on the fly by the user. E.g., https://github.com/johnsamuelwrites/inclusive/blob/master/inclusivewriting/resources/en/list.json

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

No branches or pull requests

2 participants