Incremental Project Synchronisation for PIO Plus // Resolve #825

docs/userguide/remote/cmd_agent.rst

@@ -101,6 +101,12 @@ Share your agent/devices with other PlatformIO developers who have
 The valid value for ``--share`` option is E-Mail address that was used for
 :ref:`cmd_account_register` command.
 
+.. option::
+    -d, --working-dir
+
+A working directory where :ref:`cmd_remote_agent` stores projects data for
+incremental synchronization and embedded programs for PIO Process Supervisor.
+
 ------------
 
 platformio remote agent reload

docs/userguide/remote/cmd_run.rst

@@ -33,13 +33,13 @@ Description
 -----------
 
 Process remotely environments which are defined in :ref:`projectconf` file.
-By default, :ref:`pio_remote` builds project on the local machine and deploy
-final firmware Over-The-Air (OTA) to remote device.
+By default, :ref:`pio_remote` builds project on a host machine and deploy
+final firmware Over-The-Air (OTA) to remote device (embedded board).
 
-If you need to build project on remote machine, please use
-:option:`platformio remote run --build-remotely` option. In this case,
-:ref:`pio_remote` will automatically deploy your project to remote machine,
-install required toolchains, frameworks, SDKs, etc and build/upload firmware.
+If you need to process project on remote machine, please use
+:option:`platformio remote run --force-remote` option. In this case,
+:ref:`pio_remote` will automatically synchronize your project with remote machine,
+install required toolchains, frameworks, SDKs, etc., and process project.
 
 
 Options
@@ -101,15 +101,15 @@ Disable auto-clean of :ref:`projectconf_pio_envs_dir` when :ref:`projectconf`
 or :ref:`projectconf_pio_src_dir` (project structure) have been modified.
 
 .. option::
-    -r, --build-remotely
+    -r, --force-remote
 
-By default, :ref:`pio_remote` builds project on the local machine and deploy
-final firmware Over-The-Air (OTA) to remote device.
+By default, :ref:`pio_remote` builds project on a host machine and deploy
+final firmware Over-The-Air (OTA) to remote device (embedded board).
 
-If you need to build project on remote machine, please use
-:option:`platformio remote run --build-remotely` option. In this case,
-:ref:`pio_remote` will automatically deploy your project to remote machine,
-install required toolchains, frameworks, SDKs, etc and build/upload firmware.
+If you need to process project on remote machine, please use
+:option:`platformio remote run --force-remote` option. In this case,
+:ref:`pio_remote` will automatically synchronize your project with remote machine,
+install required toolchains, frameworks, SDKs, etc., and process project.
 
 Example
 -------

docs/userguide/remote/cmd_test.rst

@@ -99,15 +99,15 @@ Specify the path to project directory. By default, ``--project-dir`` is equal
 to current working directory (``CWD``).
 
 .. option::
-    -r, --build-remotely
+    -r, --force-remote
 
-By default, :ref:`pio_remote` builds project on the local machine and deploy
-final testing firmware Over-The-Air (OTA) to remote device.
+By default, :ref:`pio_remote` processes project on a host machine and deploy
+final testing firmware Over-The-Air (OTA) to remote device (embedded board).
 
-If you need to build project on remote machine, please use
-:option:`platformio remote test --build-remotely` option. In this case,
-:ref:`pio_remote` will automatically deploy your project to remote machine,
-install required toolchains, frameworks, SDKs, etc and process tests.
+If you need to process project on remote machine, please use
+:option:`platformio remote test --force-remote` option. In this case,
+:ref:`pio_remote` will automatically synchronize your project with remote machine,
+install required toolchains, frameworks, SDKs, etc., and process project.
 
 
 .. option::