update restart documentation (#7603)

* update `restart` documentation

#7288 added support for task-specific `restart` policy. this PR updates the docs to reflect that.

* added an explicit example of task-specific restart policy

* Update website/pages/docs/job-specification/restart.mdx

website/pages/docs/job-specification/restart.mdx

@@ -7,9 +7,14 @@ description: The "restart" stanza configures a group's behavior on task failure.
 
 # `restart` Stanza
 
-<Placement groups={['job', 'group', 'restart']} />
-
-The `restart` stanza configures a group's behavior on task failure. Restarts
+<Placement
+  groups={[
+    ['job', 'group', 'restart'],
+    ['job', 'group', 'task', 'restart']
+  ]}
+/>
+
+The `restart` stanza configures a tasks's behavior on task failure. Restarts
 happen on the client that is running the task.
 
 ```hcl
@@ -23,6 +28,35 @@ job "docs" {
 }
 ```
 
+If specified at the group level, the configuration is inherited by all
+tasks in the group. If present on the task, the policy is merged with
+the restart policy from the encapsulating task group.
+
+For example, assuming that the task group restart policy is: 
+```hcl
+restart {
+  interval = "30m"
+  attempts = 2
+  delay    = "15s"
+  mode     = "fail"
+}
+```
+and the individual task restart policy is: 
+```hcl
+restart {
+  attempts = 5
+}
+```
+then the effective restart policy for the task will be: 
+```hcl
+restart {
+  interval = "30m"
+  attempts = 5
+  delay    = "15s"
+  mode     = "fail"
+}
+```
+
 ## `restart` Parameters
 
 - `attempts` `(int: <varies>)` - Specifies the number of restarts allowed in the