[gh-24311] Expand on documentation about jobs that are both parameterised and periodic

website/content/docs/job-specification/parameterized.mdx

@@ -152,9 +152,59 @@ job "email-blast" {
 }
 ```
 
+### Interactions with [`periodic`][periodic] 
+
+When trying to schedule a job that is both `parameterized` and `periodic`, an internal 
+hierarchy comes into play: A parametrized job should not be dispatched without 
+parameters by the periodic configuration, forcing the parameterized option to take
+precedence: Once the job is dispatched and given parameters, the 
+periodic configuration comes into play and a new jobs will be dispatched according 
+to the periodic configurations and with the parameters of the triggering job.
+
+For example a job with the following configuration will not trigger any new jobs 
+until it is dispatched at least once, and after that the dispatched child will 
+periodically trigger more children with the given parameters. 
+
+```hcl
+  periodic {
+    crons = [
+      "*/40 * * * * * *"
+    ]
+  }
+  parameterized {
+    payload       = "required"
+    meta_required = ["dispatcher_email"]
+    meta_optional = ["pager_email"]
+  }
+```
+
+The first job `batch/periodic/parameterized` corresponds to the parameterized and
+periodic job, but it won't result in any new allocations until a `dispatch` with the 
+necessary parameters is submitted. The second job `batch/periodic` will trigger 
+the subsequent jobs `batch`. Any new dispatch will trigger a new flow of new 
+periodic jobs with the corresponding parameters. 
+
+```
+$ nomad job status                                                      
+ID                                                     Type                            Submit Date
+sync                                                   batch/periodic/parameterized    2024-11-07T10:43:30+01:00 // Original submitted job
+sync/dispatch-1730972650-247c6e97                      batch/periodic                  2024-11-07T10:44:10+01:00 // First dispatched job with parameters A
+sync/dispatch-1730972650-247c6e97/periodic-1730972680  batch                           2024-11-07T10:44:40+01:00 // Cron job with parameters A
+sync/dispatch-1730972650-247c6e97/periodic-1730972860  batch                           2024-11-07T10:47:40+01:00 // Cron job with parameters A
+sync/dispatch-1730972760-f79a96e1                      batch/periodic                  2024-11-07T10:46:00+01:00 // Second dispatched job with parameters B
+sync/dispatch-1730972760-f79a96e1/periodic-1730972800  batch                           2024-11-07T10:46:40+01:00 // Cron job with parameters B
+sync/dispatch-1730972760-f79a96e1/periodic-1730972860  batch                           2024-11-07T10:47:40+01:00 // Cron job with parameters B
+```
+If a periodic job needs to be forced by any reason, the corresponding parameterized job needs to be used:
+
+```
+$ nomad job periodic force sync/dispatch-1730972650-247c6e97 
+```
+
 [batch-type]: /nomad/docs/job-specification/job#type 'Batch scheduler type'
 [dispatch command]: /nomad/docs/commands/job/dispatch 'Nomad Job Dispatch Command'
 [resources]: /nomad/docs/job-specification/resources 'Nomad resources Job Specification'
 [interpolation]: /nomad/docs/runtime/interpolation 'Nomad Runtime Interpolation'
 [dispatch_payload]: /nomad/docs/job-specification/dispatch_payload 'Nomad dispatch_payload Job Specification'
 [multiregion]: /nomad/docs/job-specification/multiregion#parameterized-dispatch
+[periodic]: /nomad/docs/job-specification/periodic

website/content/docs/job-specification/periodic.mdx

@@ -59,6 +59,9 @@ consistent evaluation when Nomad spans multiple time zones.
   prevents this job from running on the `cron` schedule but prevents force
   launches.
 
+See the [parameterized] documentation for additional considerations when
+using in conjunction with parameterized options.
+
 ## `periodic` Examples
 
 The following examples only show the `periodic` blocks. Remember that the
@@ -116,3 +119,4 @@ configuring time zones for periodic jobs.
 [cron]: https://github.com/hashicorp/cronexpr#implementation 'List of cron expressions'
 [dst]: #daylight-saving-time
 [multiregion]: /nomad/docs/job-specification/multiregion#periodic-time-zones
+[parameterized]: /nomad/docs/job-specification/parameterized