Refactor parameter names and update documentation (#901)

Refactored parameter names across multiple interfaces for clarity:
- `IPushesFiles.PushFile`: `base64Data` to `stringData` and `file`
- `IFindsByFluentSelector.FindElements`: `by` to `selector`
- `IInteractsWithApps`: `appPath` to `bundleId` and `appId`
- `ITouchAction.LongPress`: `el` to `element`

Updated documentation comments for better compatibility:
- `INetworkActions.ToggleData`: `<=` to `&lt;=`
- Removed empty `<param>` tag in `INetworkActions.SetGsmSignalStrength`

Author: Dor-bl

src/Appium.Net/Appium/Android/Interfaces/IPushesFiles.cs

@@ -24,7 +24,7 @@ public interface IPushesFiles : IInteractsWithFiles
         /// </summary>
         /// <param name="pathOnDevice">Path to file to write data to on remote device</param>
         /// <param name="stringData">A string to write to remote device</param>
-        void PushFile(string pathOnDevice, string base64Data);
+        void PushFile(string pathOnDevice, string stringData);
 
         /// <summary>
         /// Saves base64 encoded data as a file on the remote mobile device.
@@ -37,7 +37,7 @@ public interface IPushesFiles : IInteractsWithFiles
         /// Saves given file as a file on the remote mobile device.
         /// </summary>
         /// <param name="pathOnDevice">Path to file to write data to on remote device</param>
-        /// <param name="base64Data">A file to write to remote device</param>
+        /// <param name="file">A file to write to remote device</param>
         void PushFile(string pathOnDevice, FileInfo file);
     }
 }

src/Appium.Net/Appium/Interfaces/IFindsByFluentSelector.cs

@@ -31,7 +31,7 @@ public interface IFindsByFluentSelector<out W> where W : IWebElement
         /// Method performs the searching for a list of elements by some selector defined by string
         /// and value of the given selector
         /// </summary>
-        /// <param name="by">is a string selector</param>
+        /// <param name="selector">is a string selector</param>
         /// <param name="value">is a value of the given selector</param>
         /// <returns>a list of elements</returns>
         IReadOnlyCollection<W> FindElements(string selector, string value);

src/Appium.Net/Appium/Interfaces/IInteractsWithApps.cs

@@ -28,7 +28,7 @@ public interface IInteractsWithApps : IExecuteMethod
         /// <summary>
         /// Checks If an App Is Installed.
         /// </summary>
-        /// <param name="appPath">a string containing the bundle id.</param>
+        /// <param name="bundleId">a string containing the bundle id.</param>
         /// <return>a boolean indicating if the app is installed.</return>
         bool IsAppInstalled(string bundleId);
 
@@ -46,13 +46,13 @@ public interface IInteractsWithApps : IExecuteMethod
         /// <summary>
         /// Removes an App.
         /// </summary>
-        /// <param name="appPath">a string containing the id of the app.</param>
+        /// <param name="appId">a string containing the id of the app.</param>
         void RemoveApp(string appId);
 
         /// <summary>
         /// Activates the given app by moving to the foreground if it is running in the background or starting it if it is not running yet.
         /// </summary>
-        /// <param name="appPath">a string containing the id of the app.</param>
+        /// <param name="appId">a string containing the id of the app.</param>
         void ActivateApp(string appId);
 
         /// <summary>

src/Appium.Net/Appium/Interfaces/INetworkActions.cs

@@ -28,7 +28,7 @@ public interface INetworkActions
         /// Switch the state of data service (Emulator Only)
         /// (For Android) This API does not work for Android API level 21+
         /// because it requires system or carrier privileged permission,
-        /// and Android <= 21 does not support granting permissions.
+        /// and Android &lt;= 21 does not support granting permissions.
         /// </summary>
         void ToggleData();
 
@@ -59,7 +59,6 @@ public interface INetworkActions
         /// <summary>
         /// Sets GSM signal strength (Emulator only)
         /// </summary>
-        /// <param name=""></param>
         /// <param name="gsmSignalStrength"></param>
         void SetGsmSignalStrength(GsmSignalStrength gsmSignalStrength);
 

src/Appium.Net/Appium/Interfaces/ITouchAction.cs

@@ -25,12 +25,11 @@ public interface ITouchAction
         /// <param name="x">The x coordinate relative to the element.</param>
         /// <param name="y">The y coordinate relative to the element.</param>
         /// <returns>A self-reference to this <see cref="ITouchAction"/>.</returns>
-        ITouchAction LongPress(IWebElement el, double? x = null, double? y = null);
+        ITouchAction LongPress(IWebElement element, double? x = null, double? y = null);
 
         /// <summary>
         /// Press at the specified location until the  context menu appears.
         /// </summary>
-        /// <param name="element">The target element.</param>
         /// <param name="x">The x coordinate relative to the element.</param>
         /// <param name="y">The y coordinate relative to the element.</param>
         /// <returns>A self-reference to this <see cref="ITouchAction"/>.</returns>