use table in config ref and add note about immediate start with no delay supplied

Author: rosieyohannan

docs/guides/modules/orchestrate/pages/automatic-reruns.adoc

@@ -33,7 +33,7 @@ This section provides config examples to help you set up automatic reruns. The c
 
 To enable automatic reruns for a run step in a job, add the `max_auto_reruns` key to your step with a value between 1 and 5:
 
-NOTE: Automatic reruns are only supported for `run` steps, not special steps like `checkout` or `setup_remote_docker`.
+NOTE: Automatic reruns are only supported for `run` steps, not special steps like `checkout` or `setup_remote_docker`. Also you must configure the `command` key for the step, you cannot use the short form run step configuration.
 
 .CircleCI config to automatically retry a step up to 3 times if it fails
 [source,yaml]
@@ -44,14 +44,14 @@ jobs:
   my-job:
     steps:
       - run: echo "Hello, world!"
-      - run: 
+      - run:
           command: echo "This step will automatically rerun up to 3 times if it fails"
           max_auto_reruns: 3
 ----
 
 You can add a delay between the step failing and the automatic rerun starting, as follows:
 
-NOTE: If you configure a delay for your automatic step rerun, the delay must be less than or equal to 10 minutes. The delay can be configured as a string with a unit suffix, using `m` (minutes) or `s` (seconds), for example, `auto_rerun_delay: 10s` or `auto_rerun_delay: 3m`.
+NOTE: If you configure a delay for your automatic step rerun, the delay must be less than or equal to 10 minutes. The delay can be configured as a string with a unit suffix, using `m` (minutes) or `s` (seconds), for example, `auto_rerun_delay: 10s` or `auto_rerun_delay: 3m`. If you do not supply a delay, the rerun will start immediately after the step fails.
 
 .CircleCI config to automatically retry a step up to 3 times if it fails with a 10 second delay between attempts
 [source,yaml]
@@ -62,7 +62,7 @@ jobs:
   my-job:
     steps:
       - run: echo "Hello, world!"
-      - run: 
+      - run:
           command: echo "This step will automatically rerun up to 3 times if it fails with a 10 second delay between attempts"
           max_auto_reruns: 3
           auto_rerun_delay: 10s

docs/reference/modules/ROOT/pages/configuration-reference.adoc

@@ -1568,7 +1568,26 @@ A job can exit without failing by using `run: circleci-agent step halt`. However
 
 ==== Automatic step reruns
 
-The `max_auto_reruns` and `auto_rerun_delay` attributes can be used to automatically rerun a step if it fails, and delay that rerun if required. Automatic reruns are useful for steps that are expected to fail intermittently, such as tests.
+The following attributes can be used to automatically rerun a step if it fails, and delay that rerun if required:
+
+[cols="2,1,1,2"]
+|===
+| Key | Required | Type | Description
+
+|`max_auto_reruns`
+| N
+| Integer
+| The maximum number of times to automatically rerun the step if it fails. Must be between `1` and `5`.
+
+| `auto_rerun_delay`
+| N
+| String
+| The delay between reruns of the step if it fails. This delay can only be set along with `max_auto_reruns`. The string is a decimal with unit suffix using either seconds `s` or minutes `m` up to a maximum of 10 minutes, such as "10s", "2m". If you do not supply a delay, the rerun will start immediately after the step fails.
+|===
+
+Automatic reruns are only supported for `run` steps, not special steps like `checkout` or `setup_remote_docker`.
+
+You must configure the `command` key for the step, you cannot use the short form run step configuration, for example, the following is not supported for use with automatic reruns: `- run: echo "Hello, world!"`
 
 *Example:*