-
Notifications
You must be signed in to change notification settings - Fork 572
chore: Updates docstring #533
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
Conversation
Since type hint already added to args
unnecessary anymore since type hint works for auto completion
Except for property and TypeVar
Returns: | ||
bool: `True` if the service was running before being stopped | ||
`True` if the service was running before being stopped |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Need bool
or not?
(L198 has bool, but here has no it)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Unnecessary for here since stop() → bool
already has return type in below doc.
Return type: bool
will be removed from doc, but it's no problem from user point of view, I think.
Returns: | ||
bool: `True` if app is installed | ||
`True` if app is installed |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
bool:
?
Returns: | ||
bool: `True` if the service was running before being stopped | ||
`True` if the service was running before being stopped |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Unnecessary for here since stop() → bool
already has return type in below doc.
Return type: bool
will be removed from doc, but it's no problem from user point of view, I think.
Returns: | ||
bool: `True` or `False` | ||
bool: `True` if the service is running |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Necessary here since property
's one doesn't have bool
in below doc.
(I'd like to change here to True if the service is running
, cannot do so. I know it's not good way 🤔 .)
Currently
property is_running
Ideally like this
property is_running -> bool
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
ah, got it.
For #529
Changes