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

docs: adding missing docstrings meta-issue #3456

Closed
terriko opened this issue Oct 23, 2023 · 3 comments
Closed

docs: adding missing docstrings meta-issue #3456

terriko opened this issue Oct 23, 2023 · 3 comments
Labels
documentation Documentation changes good first issue Good for newcomers hacktoberfest good issue for hacktoberfest participation

Comments

@terriko
Copy link
Contributor

terriko commented Oct 23, 2023

I've been slowly adding issues like #3455 intended for folk participating in hacktoberfest to have an easy first issue that gets them some practice reading and understanding an unfamilar codebase. I'm one person serving as project lead and it takes a bit of time for me to find files that are worth upgrading, make an issue, and handle code review.

If you're looking for a good first issue, though, feel free to create one for yourself in a similar way. I'm using the tool interrogate to examine files using the following flags in each directory:

interrogate -vv -i -I -M -C *.py

And then filing an issue for each file that's missing stuff. If you want to file your own issue and then work on it, feel free to use a similar procedure.

  • don't forget to double-check that there isn't already a docstring issue filed for that file
  • if you intend to solve the issue you filed yourself, say so so I know to prioritize you as the person who gets the merged PR. But also feel free to file some extra issues for other people if you're bored (sadly, this won't get you any hacktoberfest credit, but you'll save me some hassle!)
@terriko terriko added good first issue Good for newcomers documentation Documentation changes hacktoberfest good issue for hacktoberfest participation labels Oct 23, 2023
@Willmayyy
Copy link

can i be assigned

@terriko
Copy link
Contributor Author

terriko commented Oct 24, 2023

@Willmayyy this isn't really the type of issue one gets assigned to since it's just an explanation of how to make new issues of the same type. But if you follow the instructions and make an issue for a file that doesn't have one, I'd be happy to assign you to your own issue!

@terriko
Copy link
Contributor Author

terriko commented Apr 17, 2024

I think we've pretty much got docstrings to a good point and interrogate is now pushing us to keep up the good work, so I'm going to go ahead and close this issue. We can revisit it again at some future date if we want to make a few more beginner-friendly issues with the last missing docstrings.

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

No branches or pull requests

2 participants