Skip to content

Conversation

ki4070ma
Copy link
Collaborator

@ki4070ma ki4070ma commented May 6, 2020

For #529

Changes

  1. Remove types from docstring since types already added to args
    • Except for property and TypeVar
  2. Changed style in usage field
  3. And so on

ki4070ma added 2 commits May 6, 2020 13:18
Since type hint already added to args
ki4070ma added 4 commits May 6, 2020 16:11
unnecessary anymore since type hint works for auto completion
@ki4070ma ki4070ma marked this pull request as ready for review May 10, 2020 04:00
@ki4070ma ki4070ma changed the title [WIP] doc: Updates docstring doc: Updates docstring May 10, 2020
Except for property and TypeVar
@ki4070ma ki4070ma changed the title doc: Updates docstring chore: Updates docstring May 10, 2020
Returns:
bool: `True` if the service was running before being stopped
`True` if the service was running before being stopped
Copy link
Member

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)

Copy link
Collaborator Author

@ki4070ma ki4070ma May 10, 2020

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.

https://appium.github.io/python-client-sphinx/webdriver.html#webdriver.appium_service.AppiumService.stop

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
Copy link
Member

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
Copy link
Collaborator Author

@ki4070ma ki4070ma May 10, 2020

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.

https://appium.github.io/python-client-sphinx/webdriver.html#webdriver.appium_service.AppiumService.stop

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
Copy link
Collaborator Author

@ki4070ma ki4070ma May 10, 2020

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 🤔 .)

https://appium.github.io/python-client-sphinx/webdriver.html#webdriver.appium_service.AppiumService.is_running

Currently

property is_running

Ideally like this

property is_running -> bool

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ah, got it.

@ki4070ma ki4070ma merged commit 8205776 into appium:master May 13, 2020
@ki4070ma ki4070ma deleted the update-doc branch May 13, 2020 11:39
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

Successfully merging this pull request may close these issues.

2 participants