pymobiledevice3: add page

[doronz88]

• The page(s) are in the correct platform directories: common, linux, osx, windows, sunos, android, etc.
• The page(s) have at most 8 examples.
• The page description(s) have links to documentation or a homepage.
• The page(s) follow the content guidelines.
• The PR title conforms to the recommended templates.
• Version of the command being documented (if known): v4.10.2

I included more then 8 examples since this CLI utility is a swiss-army-knife for doing many common operations with a connected iPhone (backup, reboot, device logs and etc) so put only the commands I heard for the community this is the most common ones to be used. I hope this is okay.

[CLAassistant]

All committers have signed the CLA.

[tldr-bot]

The build for this PR failed with the following error(s):

pages/common/pymobiledevice3.md:3: TLDR004 Command descriptions should end in a period
pages/common/pymobiledevice3.md:6: TLDR005 Example descriptions should end in a colon with no trailing characters
pages/common/pymobiledevice3.md:6: TLDR104 Example descriptions should prefer infinitive tense (e.g. write) over present (e.g. writes) or gerund (e.g. writing)
pages/common/pymobiledevice3.md:10: TLDR005 Example descriptions should end in a colon with no trailing characters
pages/common/pymobiledevice3.md:14: TLDR005 Example descriptions should end in a colon with no trailing characters
pages/common/pymobiledevice3.md:18: TLDR005 Example descriptions should end in a colon with no trailing characters
pages/common/pymobiledevice3.md:22: TLDR005 Example descriptions should end in a colon with no trailing characters
pages/common/pymobiledevice3.md:26: TLDR005 Example descriptions should end in a colon with no trailing characters
pages/common/pymobiledevice3.md:30: TLDR005 Example descriptions should end in a colon with no trailing characters
pages/common/pymobiledevice3.md:34: TLDR005 Example descriptions should end in a colon with no trailing characters
pages/common/pymobiledevice3.md:38: TLDR005 Example descriptions should end in a colon with no trailing characters
pages/common/pymobiledevice3.md:42: TLDR005 Example descriptions should end in a colon with no trailing characters
pages/common/pymobiledevice3.md:46: TLDR005 Example descriptions should end in a colon with no trailing characters
pages/common/pymobiledevice3.md:50: TLDR005 Example descriptions should end in a colon with no trailing characters
pages/common/pymobiledevice3.md:58: TLDR005 Example descriptions should end in a colon with no trailing characters
pages/common/pymobiledevice3.md:62: TLDR005 Example descriptions should end in a colon with no trailing characters
pages/common/pymobiledevice3.md:66: TLDR005 Example descriptions should end in a colon with no trailing characters
pages/common/pymobiledevice3.md:70: TLDR005 Example descriptions should end in a colon with no trailing characters
pages/common/pymobiledevice3.md:74: TLDR005 Example descriptions should end in a colon with no trailing characters
pages/common/pymobiledevice3.md:78: TLDR005 Example descriptions should end in a colon with no trailing characters
pages/common/pymobiledevice3.md:82: TLDR005 Example descriptions should end in a colon with no trailing characters
pages/common/pymobiledevice3.md:86: TLDR005 Example descriptions should end in a colon with no trailing characters
pages/common/pymobiledevice3.md:94: TLDR104 Example descriptions should prefer infinitive tense (e.g. write) over present (e.g. writes) or gerund (e.g. writing)
pages/common/pymobiledevice3.md:98: TLDR005 Example descriptions should end in a colon with no trailing characters
pages/common/pymobiledevice3.md:102: TLDR005 Example descriptions should end in a colon with no trailing characters
pages/common/pymobiledevice3.md:106: TLDR005 Example descriptions should end in a colon with no trailing characters
pages/common/pymobiledevice3.md:110: TLDR005 Example descriptions should end in a colon with no trailing characters
pages/common/pymobiledevice3.md:0: TLDR019 Page should only include a maximum of 8 examples

Please fix the error(s) and push again.

[tldr-bot]

The build for this PR failed with the following error(s):

pages/common/pymobiledevice3.md:0: TLDR019 Page should only include a maximum of 8 examples

Please fix the error(s) and push again.

[tldr-bot]

The build for this PR failed with the following error(s):

pages/common/pymobiledevice3.md:0: TLDR019 Page should only include a maximum of 8 examples

Please fix the error(s) and push again.

[sebastiaanspeck]

I think it is better if we split this page in subcommand-pages, so this page could list some of the subcommands like:

# pymobiledevice3

> Interact with a connected iDevice (iPhone, iPad, ...).
> Some subcommands such as `pymobiledevice3 syslog` have their own usage documentation.
> More information: <https://github:com/doronz88/pymobiledevice3>.

- View documentation for syslog:

`tldr pymobiledevice3 syslog`

- View documentation for usbmux:

`tldr pymobiledevice3 usbmux`

[doronz88]

The problem with that is that on many occasions people don't know the subcommand that are looking for by the subcommand. For example, most people don't know at first that usbmux is used for TCP forwarding and discovering the connected device list though it is clear for those that read the full documentation

[sebastiaanspeck]

The problem with that is that on many occasions people don't know the subcommand that are looking for by the subcommand. For example, most people don't know at first that usbmux is used for TCP forwarding and discovering the connected device list though it is clear for those that read the full documentation

Therefore you should provide a clear description:

# pymobiledevice3

> Interact with a connected iDevice (iPhone, iPad, ...).
> Some subcommands such as `pymobiledevice3 syslog` have their own usage documentation.
> More information: <https://github:com/doronz88/pymobiledevice3>.

- View documentation for syslog:

`tldr pymobiledevice3 syslog`

- View documentation for TCP forwarding and discovering the connected device list:

`tldr pymobiledevice3 usbmux`

[doronz88]

I see. However, this would completely defeat the purpose of tldr in that case since it will be the equivalent of just hitting each subcommand and view its usage.

[doronz88]

Is there instead maybe a way to just tldr to look at additional PATH for other commands?