Address PR review comments for Salesforce integration docs

Author: greenberga

src/pages/integrations/salesforce/index.md

@@ -12,8 +12,8 @@ description: Integrate Friendly Captcha into your Salesforce environment
 Integrating Friendly Captcha involves a front-end component and a back-end component. We recommend familiarizing yourself with the [Friendly Captcha documentation][fcdocs] to develop a baseline understanding of how an integration works.
 
 For the front-end component of the integration, this package provides a Lightning Web
-Component (LWC). If you're using Visualforce, you should also be able to simply insert
-[the standard markup][html] for the front-end integration.
+Component (LWC). If you're using Visualforce, you should be able to insert
+[the standard markup][html] for the front-end integration, instead of using the LWC.
 
 For the back-end component of the integration, this package provides an Apex class that
 performs an HTTP request to the Friendly Captcha site verification API.
@@ -53,10 +53,10 @@ Click the **Manage Records** link, and then edit the **Settings** record. You'll
 
 | Setting | Location | Description |
 | -- | -- | -- |
-| Sitekey | Shared | A Friendly Captcha sitekey associated with an application. Copied from the application configuration in the Friendly Captcha dashboard. |
+| Sitekey | Shared | A Friendly Captcha sitekey associated with an application. You can find this value in the application configuration in the Friendly Captcha dashboard. |
 | APIEndpoint | Shared | The endpoint URL used for communicating with the Friendly Captcha API. Shorthands 'eu' or 'global' are accepted. Default is 'global'. Using the 'eu' endpoint requires access that must be enabled in the Friendly Captcha dashboard. |
-| APIKey | Apex | An API key used for communicating with the Friendly Captcha API. Created in the Friendly Captcha dashboard. |
-| Strict | Apex | Determines the failure mode behavior of the captcha response verification (siteverify) result. This mode only applies when the API was not able to verify the response, which might occur for network connectivity reasons or a misconfiguration of the client. When 'strict' is enabled, unverified responses will be set to 'reject', in a fail-closed behavior. When disabled (the default), unverified responses will be set to 'accept', in a fail-open behavior. |
+| APIKey | Apex | An API key used for communicating with the Friendly Captcha API. You can create an API key in the Friendly Captcha dashboard. |
+| Strict | Apex | Determines the failure mode behavior of the captcha response verification (siteverify) result. This mode only applies when the API was not able to verify the response, which might occur for network connectivity reasons or a misconfiguration of the client. When 'strict' is enabled, unverified responses will be set to 'reject' (i.e. fail-closed behavior). When disabled (the default), unverified responses will be set to 'accept' (i.e. fail-open behavior). |
 | Timeout | Apex | How long (in milliseconds) to wait for a captcha response verification request to complete. |
 | StartMode | LWC | The start mode determines the behavior around automatic activation of the widget. Activation here means the challenge gets requested and gets solved. |
 | Theme | LWC | The theme for the widget. |
@@ -196,7 +196,7 @@ Here's the final Flow:
 
 ### Lightning Web Component
 
-Using the LWC from code (e.g., from within another LWC) looks like this:
+Using the LWC from code (e.g. from within another LWC) looks like this:
 
 ```
 <friendlycaptcha-widget

src/pages/integrations/salesforce/reference/classes/VerifyResult.md

@@ -1,16 +1,24 @@
 # VerifyResult Class
 
 VerifyResult is a wrapper around the response of an 
-/api/v2/captcha/siteverify request. 
+ `/api/v2/captcha/siteverify` request. 
 
 The main methods are `shouldAccept` and `wasAbleToVerify` . 
 The first one you should use to determine if the user's request should be accepted; 
 the second one to determine if the request was able to be verified. 
-If that returns false, you should alert yourself.
+If that returns false, it means that there was an issue in the communication with the 
+Friendly Captcha API, and you should log an error or notify your monitoring system.
 
 ## Methods
 ### `isStrict()`
 
+Whether the `strict` option was set to true on the client. 
+In `strict` mode this will only return `true` if the request was successful 
+(e.g. verification could happen), and the challenge was solved successfully. 
+ 
+By default, `strict` is set to `false` , which means that the request 
+will be accepted if the challenge could not be verified (also called *fail open*).
+
 #### Signature
 ```apex
 global Boolean isStrict()
@@ -19,13 +27,13 @@ global Boolean isStrict()
 #### Return Type
 **Boolean**
 
-whether the ,[object Object], option was set to true on the client. In,[object Object],        ,[object Object], mode this will only return ,[object Object],[object Object],        if the request was successful (e.g. verification could happen), and,[object Object],        the challenge was solved successfully.,[object Object],,[object Object],        By default, ,[object Object], is set to ,[object Object],, which means that the request,[object Object],        will be accepted if the challenge could,[object Object],        not be verified (also called *fail open*).
-
 ---
 
 ### `shouldAccept()`
 
-Determines if the user's request should be accepted.
+Determines if the user's request should be accepted. 
+ 
+Returns true if the request should be accepted, false otherwise.
 
 #### Signature
 ```apex
@@ -35,13 +43,13 @@ global Boolean shouldAccept()
 #### Return Type
 **Boolean**
 
-true if the request should be accepted, false otherwise.
-
 ---
 
 ### `shouldReject()`
 
-Determines if the user's request should be rejected.
+Determines if the user's request should be rejected. 
+ 
+Returns rue if the request should be rejected, false otherwise.
 
 #### Signature
 ```apex
@@ -51,14 +59,14 @@ global Boolean shouldReject()
 #### Return Type
 **Boolean**
 
-true if the request should be rejected, false otherwise.
-
 ---
 
 ### `isEncodeError()`
 
 Was unable to encode the captcha response. This means the captcha response 
-was invalid and should never be accepted.
+was invalid and should never be accepted. 
+ 
+Returns rue if there was an encoding error, false otherwise.
 
 #### Signature
 ```apex
@@ -68,14 +76,14 @@ global Boolean isEncodeError()
 #### Return Type
 **Boolean**
 
-true if there was an encoding error, false otherwise.
-
 ---
 
 ### `isRequestError()`
 
 Something went wrong making the request to the Friendly Captcha API, perhaps 
-there is a network connection issue?
+there is a network connection issue? 
+ 
+Returns true if there was a request error, false otherwise.
 
 #### Signature
 ```apex
@@ -85,13 +93,13 @@ global Boolean isRequestError()
 #### Return Type
 **Boolean**
 
-true if there was a request error, false otherwise.
-
 ---
 
 ### `isDecodeError()`
 
-Something went wrong decoding the response from the Friendly Captcha API.
+Something went wrong decoding the response from the Friendly Captcha API. 
+ 
+Returns true if there was a decoding error, false otherwise.
 
 #### Signature
 ```apex
@@ -101,8 +109,6 @@ global Boolean isDecodeError()
 #### Return Type
 **Boolean**
 
-true if there was a decoding error, false otherwise.
-
 ---
 
 ### `isClientError()`
@@ -111,7 +117,9 @@ Something went wrong on the client side, this generally means your
 configuration is wrong. 
 Check your secrets (API key) and sitekey. 
 
-See `response.error` for more details.
+See `response.error` for more details. 
+ 
+Returns true if there was a client error, false otherwise.
 
 #### Signature
 ```apex
@@ -121,14 +129,14 @@ global Boolean isClientError()
 #### Return Type
 **Boolean**
 
-true if there was a client error, false otherwise.
-
 ---
 
 ### `getResponse()`
 
 Get the response as was sent from the server. 
-This can be null if the request to the API could not be made successfully.
+This can be null if the request to the API could not be made successfully. 
+ 
+Returns the response from the server, or null if the request failed.
 
 #### Signature
 ```apex
@@ -138,13 +146,13 @@ global VerifyResponse getResponse()
 #### Return Type
 **[VerifyResponse](VerifyResponse)**
 
-the response from the server, or null if the request failed.
-
 ---
 
 ### `getErrorCode()`
 
-Get the error code.
+Get the error code. 
+ 
+Returns the error code, or null if not present.
 
 #### Signature
 ```apex
@@ -154,13 +162,13 @@ global String getErrorCode()
 #### Return Type
 **String**
 
-the error code, or null if not present.
-
 ---
 
 ### `getErrorDetail()`
 
-Get the error detail.
+Get the error detail. 
+ 
+Returns the error detail, or null if not present.
 
 #### Signature
 ```apex
@@ -170,16 +178,16 @@ global String getErrorDetail()
 #### Return Type
 **String**
 
-the error detail, or null if not present.
-
 ---
 
 ### `wasAbleToVerify()`
 
 Whether the request to verify the captcha was completed. In other words: the 
 API responded with status 200. 
 If this is false, you should notify yourself and check `getErrorCode()` to see 
-what is wrong.
+what is wrong. 
+ 
+Returns true if the request was able to be verified, false otherwise.
 
 #### Signature
 ```apex
@@ -189,13 +197,13 @@ global Boolean wasAbleToVerify()
 #### Return Type
 **Boolean**
 
-true if the request was able to be verified, false otherwise.
-
 ---
 
 ### `getException()`
 
-Get the exception that was thrown, if any.
+Get the exception that was thrown, if any. 
+ 
+Returns the exception, or null if none was thrown.
 
 #### Signature
 ```apex
@@ -205,7 +213,5 @@ global Exception getException()
 #### Return Type
 **Exception**
 
-the exception, or null if none was thrown.
-
 ## Classes
 ### NullErrorException Class

src/pages/integrations/salesforce/reference/index.md

@@ -35,12 +35,13 @@ For more information, see [the API response documentation](/docs/v2/api/siteveri
 ### [VerifyResult](classes/VerifyResult)
 
 VerifyResult is a wrapper around the response of an 
-/api/v2/captcha/siteverify request. 
+ `/api/v2/captcha/siteverify` request. 
 
 The main methods are `shouldAccept` and `wasAbleToVerify` . 
 The first one you should use to determine if the user's request should be accepted; 
 the second one to determine if the request was able to be verified. 
-If that returns false, you should alert yourself.
+If that returns false, it means that there was an issue in the communication with the 
+Friendly Captcha API, and you should log an error or notify your monitoring system.
 
 ## Custom Objects