Merge pull request #421 from raspberrypi/develop

Docs 80 (#414)

Author: stevedavies-rp

documentation/asciidoc/services/connect/images/turn-off-connect.png

@@ -1,15 +1,49 @@
 == Manually start and stop Connect
 
-To start Connect or Connect Lite from the command line, run the following command:
+You can turn Connect on and off from either the desktop or the command line:
 
+[tabs]
+======
+Desktop::
++
+To turn on Connect:
++
+From the Connect icon in the menu bar, select **Turn On Raspberry Pi Connect**. 
++
+If you aren't already signed in with your Raspberry Pi ID, a browser will open and you will be prompted to do so now. Once you've signed in, your Raspberry Pi links to your Connect account.
++
+image::images/turn-on-connect.png[alt="The Connect interface, showing the Turn On Raspberry Pi Connect dropdown menu option.",width="80%"]
++
+To turn off Connect:
++
+From the Connect icon in the menu bar, select **Turn Off Raspberry Pi Connect**. 
++
+This stops Connect from running.
++
+image::images/turn-off-connect.png[alt="The Connect interface, showing the Turn Off Raspberry Pi Connect dropdown menu option."width="80%"]
+
+CLI::
++
+To turn on Connect, run the following command:
++
 [source,console]
 ----
 $ rpi-connect on
 ----
-
++
+This turns the Connect service on, but doesn't sign you in.
++
+To sign in, run the following command:
++
+[source,console]
+----
+$ rpi-connect signin
+----
++
 To stop Connect, run the following command:
-
++
 [source,console]
 ----
 $ rpi-connect off
 ----
+======

documentation/asciidoc/services/connect/install.adoc

@@ -4,7 +4,7 @@ Raspberry Pi Connect provides secure access to your Raspberry Pi from anywhere i
 
 image::images/hero.png[width="100%"]
 
-Connect is installed by default in Raspberry Pi OS Desktop and Raspberry Pi OS Full (desktop with recommended software). An alternate *Lite* variant of Connect, that only supports remote shell access with no ability to screen share, is installed by default in Raspberry Pi OS Lite.
+Connect is installed by default in Raspberry Pi OS Desktop and Raspberry Pi OS Full (desktop with recommended software). An alternate *Lite* variant of Connect, which supports only remote shell access with no ability to screen share, is installed by default in Raspberry Pi OS Lite.
 
 To use Connect, xref:connect.adoc#link-connect[link your device with a Connect account]. Visit https://connect.raspberrypi.com[connect.raspberrypi.com] to access the desktop or a shell running on your Raspberry Pi in a browser window.
 

documentation/asciidoc/services/connect/introduction.adoc

@@ -4,8 +4,6 @@
 
 * Screen sharing only supports sharing a single, primary display of your Raspberry Pi. When a Raspberry Pi is connected to multiple HDMI screens, Connect sometimes shares the contents of the secondary screen. You can work around this by right-clicking the desktop and changing the location of the taskbar in **Desktop Preferences...**.
 
-* Connect does not support on-screen keyboards. For full functionality, use a physical keyboard.
-
 * Connect requires a browser that implements https://caniuse.com/?search=es2022[ECMAScript 2022] (ES13) as it makes use of features unavailable in older browsers.
 
 * Browsers intercept certain keys and key combinations. As a result, you can't type these keys into your Connect window. Screen sharing includes a toolbar to simulate some of the most popular intercepted keys.

documentation/asciidoc/services/connect/troubleshooting.adoc

@@ -11,11 +11,11 @@ Desktop::
 +
 From the Connect icon in the menu bar, select **Turn On Raspberry Pi Connect**. This opens your browser, where you're prompted to sign in with your Raspberry Pi ID:
 +
-image::images/browser-sign-in.png[width="80%"]
+image::images/browser-sign-in.png[alt="The Connect page with a prompt to sign in to Connect with your Raspberry Pi ID.",width="80%"]
 +
 If you've already turned on Connect, choose **Sign In...** from the dropdown menu:
 +
-image::images/sign-in.png[width="80%"]
+image::images/sign-in.png[alt="The Connect page, showing sign in selected from the Raspberry Pi Connect drop down menu.",width="80%"]
 +
 If you don't already have a Raspberry Pi ID, select the *create one for free* link to xref:id.adoc#create-a-raspberry-pi-id[create one].
 
@@ -70,17 +70,17 @@ If you save your auth key to `+.config/com.raspberrypi.connect/auth.key+` in you
 
 After authenticating, assign a name to your device. Choose a name that uniquely identifies the device.
 
-image::images/new-device.png[width="80%"]
+image::images/new-device.png[alt="The Connect page inviting you to create a new device and sign in.",width="80%"]
 
 If you're an administrator of an xref:connect.adoc#connect-organisations[organisation], select whether to add this device to your personal account or to a specific organisation.
 
-image::images/new-organisation-device.png[width="80%"]
+image::images/new-organisation-device.png[alt="The Connect page, showing the new device account selection screen.",width="80%"]
 
 Select the **Create device and sign in** button to continue.
 
 You can now remotely connect to your device. The Connect icon in your menu bar turns blue to indicate that your device is signed in to the Connect service. You should receive an email notification indicating that a new device is linked to your Connect account.
 
-image::images/sign-in-email.png[width="70%"]
+image::images/sign-in-email.png[alt="The Connect page, showing the account sign in notification screen.",width="70%"]
 
 WARNING: If you receive an email that says a device that you don't recognise has signed into Connect, change your Raspberry Pi ID password immediately. Follow the instructions in xref:connect.adoc#manage-devices[Remove the device from Connect] to permanently disassociate it from your account. Consider xref:id.adoc#enable-two-factor-authentication[enabling two-factor authentication] to keep your account secure.
 
@@ -98,13 +98,13 @@ Connect lists all your linked devices on the *Devices* tab. For organisations, y
 
 Sign in to https://connect.raspberrypi.com[connect.raspberrypi.com] and go to the **Devices** tab. Connect displays a list of linked devices.
 
-image::images/devices.png[width="80%"]
+image::images/devices.png[alt="The Connect page, showing the linked devices screen.",width="80%"]
 
 (Connect for Organisations only) To search for a device by its name, enter text in the *Search* field. Connect matches results as you type.
 
 (Connect for Organisations only) To filter your device list, select *Filter* and choose from the available filter options. You can filter your devices by the device model, the amount of memory it has, or the installed operating system.
 
-image::images/filters.png[width="80%"]
+image::images/filters.png[alt="The Connect page, showing the linked device screen with filters applied.",width="80%"]
 
 This feature is available only for devices running the client version 2.9.0 or later. To update Connect on your devices, see <<update>>.
 
@@ -124,15 +124,15 @@ Sign in to https://connect.raspberrypi.com[connect.raspberrypi.com] and go to th
 
 Devices available for screen sharing show a grey **Screen sharing** badge below the name of the device.
 
-image::images/devices.png[width="80%"]
+image::images/devices.png[alt="The Connect page, showing devices listed as available for screen sharing.",width="80%"]
 
 Select the **Connect via** button to the right of the device you want to access. Select the **Screen sharing** option from the menu. This opens a browser window that displays your device's desktop.
 
-image::images/waiting-for-screen-sharing.png[width="80%"]
+image::images/waiting-for-screen-sharing.png[alt="A browser window open with a message indicating that a response is being awaited from the Raspberry Pi device.",width="80%"]
 
 You can now use your device as you would locally. For more information about the connection, hover your mouse over the padlock icon immediately to the right of the **Disconnect** button.
 
-image::images/screen-sharing.png[width="80%"]
+image::images/screen-sharing.png[alt="The Connect page, showing the Raspberry Pi dropdown menu.",width="80%"]
 
 TIP: Use the **Copy from remote** and **Paste to remote** buttons above your desktop to transfer text between your local and remote clipboards.
 
@@ -144,6 +144,21 @@ The Connect icon in the system tray rotates when a screen sharing session is in
 
 image::images/screen-sharing-notification.png[width="80%"]
 
+==== Screen sharing interface
+
+Connect's screen sharing interface is designed for both desktop and mobile devices.
+
+image::images/screen-sharing.png[alt="The Raspberry Pi Connect screen sharing interface includes shortcut keys at the bottom left of the browser window.", width="100%"]
+
+You can simulate common keyboard functions using the buttons at the bottom left of the interface:
+
+* Keyboard. Toggles the on-screen keyboard. Displayed only on mobile devices.
+* Ctrl. Simulates holding down this key on a physical keyboard.
+* Super key. Simulates holding down this key on a physical keyboard.
+* Alt. Simulates holding down this key on a physical keyboard.
+* Esc. Simulates a single press - pressing and then releasing -  of this key.
+* Tab. Simulates a single press - pressing and then releasing - of this key.
+
 ==== Stop screen sharing
 
 To close a screen sharing session, select the **Disconnect** button above your desktop.