cleaned readmes

Author: GSmithApps

polling-frequent/README.md

@@ -1,13 +1,8 @@
-# Infrequently Polling Activity
+# Frequently Polling Activity
 
-This sample shows how to use Activity retries for infrequent polling of a third-party service (for example via REST). This method can be used for infrequent polls of one minute or slower.
+This sample shows how we can implement frequent polling (1 second or faster) inside our Activity. The implementation is a loop that polls our service and then sleeps for the poll interval (1 second in the sample).
 
-Activity retries are utilized for this option, setting the following Retry options:
-
-- `BackoffCoefficient`: to 1
-- `InitialInterval`: to the polling interval (in this sample set to 60 seconds)
-
-This will enable the Activity to be retried on the set interval.
+To ensure that polling Activity is restarted in a timely manner, we make sure that it heartbeats on every iteration. Note that heartbeating only works if we set the `HeartbeatTimeout` to a shorter value than the Activity `StartToCloseTimeout` timeout.
 
 ### Running this sample
 
@@ -16,5 +11,7 @@ This will enable the Activity to be retried on the set interval.
 1. `npm run start.watch` to start the Worker.
 1. In another shell, `npm run workflow` to run the Workflow Client.
 
-The Workflow will call the actitity and it will fail four times, then
-succeed on the fifth and log `Hello, Temporal!`
+The Workflow will call the activity and it will call the test service.
+The test service will either succeed or fail by generating a random number between 0 and 1:
+if less than .2, then it will succeed; otherwise it will fail.
+It logs the generated numbers, and when it succeeds, it will log `Hello, Temporal!`.

polling-infrequent/README.md

@@ -5,7 +5,7 @@ This sample shows how to use Activity retries for infrequent polling of a third-
 Activity retries are utilized for this option, setting the following Retry options:
 
 - `BackoffCoefficient`: to 1
-- `InitialInterval`: to the polling interval (in this sample set to 60 seconds)
+- `InitialInterval`: to the polling interval (in this sample set to 5 seconds for convenience, but would be at least 60 seconds in real world situations)
 
 This will enable the Activity to be retried on the set interval.
 
@@ -16,5 +16,7 @@ This will enable the Activity to be retried on the set interval.
 1. `npm run start.watch` to start the Worker.
 1. In another shell, `npm run workflow` to run the Workflow Client.
 
-The Workflow will call the actitity and it will fail four times, then
-succeed on the fifth and log `Hello, Temporal!`
+The Workflow will call the activity and it will call the test service.
+The test service will either succeed or fail by generating a random number between 0 and 1:
+if less than .2, then it will succeed; otherwise it will fail.
+It logs the generated numbers, and when it succeeds, it will log `Hello, Temporal!`.