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

Many improvements to documentation #3177

Closed
wants to merge 1 commit into from

Conversation

Gitoffthelawn
Copy link
Contributor

Improved clarity, grammar, consistency, punctuation, and formatting.

Thank you for the great tool!

Improved clarity, grammar, consistency, punctuation, and formatting.

Thank you for the great tool!
Copy link
Collaborator

@rom1v rom1v left a comment

Choose a reason for hiding this comment

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

Thank you for the improvements (I'm not native English) 👍

Globally ok for many changes, some remarks inline.

README.md Show resolved Hide resolved
README.md Show resolved Hide resolved
README.md Show resolved Hide resolved
@@ -772,7 +771,7 @@ Any <kbd>Ctrl</kbd> shortcut is forwarded to the device. In particular:
This typically works as you expect.

The actual behavior depends on the active application though. For example,
_Termux_ sends SIGINT on <kbd>Ctrl</kbd>+<kbd>c</kbd> instead, and _K-9 Mail_
`Termux` sends SIGINT on <kbd>Ctrl</kbd>+<kbd>c</kbd> instead, and `K-9 Mail`
Copy link
Collaborator

Choose a reason for hiding this comment

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

(I prefer italic for program names.)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Sounds good. What about for scrpy and adb?

Consistency will help add clarity. What do you think?

Copy link
Collaborator

Choose a reason for hiding this comment

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

I would say, as a general rule:

  • italic when it's the program name ("the adb connection")
  • backquotes when it's the command ("run adb")

(Sometimes, the distinction is not clear.)

README.md Show resolved Hide resolved
@@ -162,7 +162,7 @@ You can also [build the app manually][BUILD].

## Run

Plug an Android device, and execute:
Plug in an Android device to your computer, and execute:
Copy link
Contributor

Choose a reason for hiding this comment

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

Hi, sorry for butting in, but I think "Plug an Android device into your computer" would be better.

More precisely, hold <kbd>Ctrl</kbd> while pressing the left-click button. Until
the left-click button is released, all mouse movements scale and rotate the
content (if supported by the app) relative to the center of the screen.
More precisely, hold <kbd>Ctrl</kbd> down while pressing the left-click button.
Copy link
Contributor

Choose a reason for hiding this comment

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

I think "hold down Ctrl" sounds better than "hold Ctrl down".

rom1v pushed a commit that referenced this pull request Apr 16, 2022
Improve clarity, grammar, consistency, punctuation, and formatting.

PR #3177 <#3177>

Signed-off-by: Romain Vimont <rom@rom1v.com>
@rom1v
Copy link
Collaborator

rom1v commented Apr 16, 2022

I rebased, replaced some quoted text by italic, and included remarks from @JohnVeness.

Please review 😉 Is it ok for both of you?

Thank you.

@JohnVeness
Copy link
Contributor

Looks good to me 👍

@rom1v
Copy link
Collaborator

rom1v commented Apr 22, 2022

Merged: 3c8ebf9

@rom1v rom1v closed this Apr 22, 2022
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.

3 participants