Use offsets for headings

Signed-off-by: Guillermo González de Agüero <[email protected]>

Author: ggam

src/main/asciidoc/batch-processing/batch-processing.adoc

@@ -1,4 +1,4 @@
-=== Batch Processing
+= Batch Processing
 
 [[GKJIQ6]][[batch-processing]]
 

src/main/asciidoc/batch-processing/batch-processing001.adoc

@@ -1,6 +1,6 @@
 [[BCGJDEEH]][[introduction-to-batch-processing]]
 
-==== Introduction to Batch Processing
+== Introduction to Batch Processing
 
 Some enterprise applications contain tasks that can be executed without
 user interaction. These tasks are executed periodically or when resource
@@ -38,7 +38,7 @@ other common characteristics of batch frameworks.
 
 [[sthref261]][[steps-in-batch-jobs]]
 
-===== Steps in Batch Jobs
+=== Steps in Batch Jobs
 
 A step is an independent and sequential phase of a batch job. Batch jobs
 contain chunk-oriented steps and task-oriented steps.
@@ -98,7 +98,7 @@ files from the bills generated for the previous month.
 
 [[sthref263]][[parallel-processing]]
 
-===== Parallel Processing
+=== Parallel Processing
 
 Batch jobs often process large amounts of data or perform
 computationally expensive operations. Batch applications can benefit
@@ -115,7 +115,7 @@ run in parallel.
 
 [[sthref264]][[status-and-decision-elements]]
 
-===== Status and Decision Elements
+=== Status and Decision Elements
 
 Batch frameworks keep track of a status for every step in a job. The
 status indicates if a step is running or if it has completed. If the
@@ -147,7 +147,7 @@ ends."]
 
 [[sthref266]][[batch-framework-functionality]]
 
-===== Batch Framework Functionality
+=== Batch Framework Functionality
 
 Batch applications have the following common requirements.
 

src/main/asciidoc/batch-processing/batch-processing002.adoc

@@ -1,6 +1,6 @@
 [[BCGGIBHA]][[batch-processing-in-jakarta-ee]]
 
-==== Batch Processing in Jakarta EE
+== Batch Processing in Jakarta EE
 
 This section lists the components of the batch processing framework in
 Jakarta EE and provides an overview of the steps you have to follow to
@@ -17,7 +17,7 @@ The following topics are addressed here:
 
 [[BABEAFJI]][[the-batch-processing-framework]]
 
-===== The Batch Processing Framework
+=== The Batch Processing Framework
 
 Jakarta EE includes a batch processing framework that consists of the
 following elements:
@@ -39,7 +39,7 @@ Java classes to run the jobs in a batch application.
 
 [[BABCGDHJ]][[creating-batch-applications]]
 
-===== Creating Batch Applications
+=== Creating Batch Applications
 
 The process for creating a batch application in Jakarta EE is the
 following.
@@ -59,7 +59,7 @@ the batch processing framework in Jakarta EE to create batch applications.
 
 [[BABDGDJB]][[elements-of-a-batch-job]]
 
-===== Elements of a Batch Job
+=== Elements of a Batch Job
 
 A batch job can contain one or more of the following elements:
 
@@ -89,7 +89,7 @@ the next step or to terminate the batch job.
 
 [[BABHJEJC]][[properties-and-parameters]]
 
-===== Properties and Parameters
+=== Properties and Parameters
 
 Jobs and steps can have a number of properties associated with them. You
 define properties in the job definition file, and batch artifacts access
@@ -118,7 +118,7 @@ Application].
 
 [[BABHJGDH]][[job-instances-and-job-executions]]
 
-===== Job Instances and Job Executions
+=== Job Instances and Job Executions
 
 A job definition can have multiple instances, each with different
 parameters. A job execution is an attempt to run a job instance. The
@@ -128,7 +128,7 @@ link:#BCGIBGFC[Checking the Status of a Job].
 
 [[BABBFGEF]][[batch-and-exit-status]]
 
-===== Batch and Exit Status
+=== Batch and Exit Status
 
 The state of jobs, steps, splits, and flows is represented in the batch
 runtime as a batch status value. Batch status values are listed

src/main/asciidoc/batch-processing/batch-processing003.adoc

@@ -1,6 +1,6 @@
 [[BCGHBJIG]][[simple-use-case]]
 
-==== Simple Use Case
+== Simple Use Case
 
 This section demonstrates how to define a simple job using the Job
 Specification Language (JSL) and how to implement the corresponding
@@ -35,7 +35,7 @@ follows:
 
 [[sthref268]][[chunk-step]]
 
-===== Chunk Step
+=== Chunk Step
 
 In most cases, you have to implement a checkpoint class for
 chunk-oriented steps. The following class just keeps track of the line
@@ -162,7 +162,7 @@ public class MyWriter implements javax.batch.api.chunk.ItemWriter {
 
 [[sthref269]][[task-step]]
 
-===== Task Step
+=== Task Step
 
 The task step displays the length of the output file. In more complex
 scenarios, task steps perform any task that does not fit the chunk

src/main/asciidoc/batch-processing/batch-processing004.adoc

@@ -1,6 +1,6 @@
 [[BCGDDBBG]][[using-the-job-specification-language]]
 
-==== Using the Job Specification Language
+== Using the Job Specification Language
 
 The Job Specification Language (JSL) enables you to define the steps in
 a job and their execution order using an XML file. The following example
@@ -56,7 +56,7 @@ child elements.
 
 [[sthref270]][[the-job-element]]
 
-===== The job Element
+=== The job Element
 
 The `job` element is always the top-level element in a job definition
 file. Its main attributes are `id` and `restartable`. The `job` element
@@ -93,7 +93,7 @@ executes first.
 
 [[sthref271]][[the-step-element]]
 
-===== The step Element
+=== The step Element
 
 The `step` element can be a child of the `job` and `flow` elements. Its
 main attributes are `id` and `next`. The `step` element can contain the
@@ -172,7 +172,7 @@ The following is an example of a task step:
 
 [[sthref272]][[the-chunk-element]]
 
-====== The chunk Element
+==== The chunk Element
 
 The `chunk` element is a child of the `step` element for chunk-oriented
 steps. The attributes of this element are listed in link:#BCGJCIEI[Table
@@ -298,7 +298,7 @@ attempts.
 
 [[sthref274]][[the-batchlet-element]]
 
-====== The batchlet Element
+==== The batchlet Element
 
 The `batchlet` element is a child of the `step` element for
 task-oriented steps. This element only has the `ref` attribute, which
@@ -322,7 +322,7 @@ This example defines a batch step and specifies its batch artifact.
 
 [[sthref275]][[the-partition-element]]
 
-====== The partition Element
+==== The partition Element
 
 The `partition` element is a child of the `step` element. It indicates
 that a step is partitioned. Most partitioned steps are chunk steps where
@@ -462,7 +462,7 @@ interface.
 
 [[sthref276]][[the-flow-element]]
 
-===== The flow Element
+=== The flow Element
 
 The `flow` element can be a child of the `job`, `flow`, and `split`
 elements. Its attributes are `id` and `next`. Flows can transition to
@@ -497,7 +497,7 @@ last step does not have the `next` attribute. The flow transitions to
 
 [[sthref277]][[the-split-element]]
 
-===== The split Element
+=== The split Element
 
 The `split` element can be a child of the `job` and `flow` elements. Its
 attributes are `id` and `next`. Splits can transition to splits, steps,
@@ -519,7 +519,7 @@ concurrently:
 
 [[sthref278]][[the-decision-element]]
 
-===== The decision Element
+=== The decision Element
 
 The `decision` element can be a child of the `job` and `flow` elements.
 Its attributes are `id` and `next`. Steps, flows, and splits can

src/main/asciidoc/batch-processing/batch-processing005.adoc

@@ -1,6 +1,6 @@
 [[BCGHDHGH]][[creating-batch-artifacts]]
 
-==== Creating Batch Artifacts
+== Creating Batch Artifacts
 
 After you define a job in terms of its batch artifacts using the Job
 Specification Language (JSL), you create these artifacts as Java classes
@@ -19,7 +19,7 @@ The following topics are addressed here:
 
 [[BABDAIBI]][[batch-artifact-interfaces]]
 
-===== Batch Artifact Interfaces
+=== Batch Artifact Interfaces
 
 The following tables list the interfaces that you implement to create
 batch artifacts. The interface implementations are referenced from the
@@ -163,7 +163,7 @@ referenced from the `listener` element inside the `step` element.
 
 [[BCGIFJBB]][[dependency-injection-in-batch-artifacts]]
 
-===== Dependency Injection in Batch Artifacts
+=== Dependency Injection in Batch Artifacts
 
 To ensure that Jakarta Contexts and Dependency Injection (CDI) works in your
 batch artifacts, follow these steps.
@@ -246,7 +246,7 @@ injected objects.
 
 [[BCGCJEEF]][[using-the-context-objects-from-the-batch-runtime]]
 
-===== Using the Context Objects from the Batch Runtime
+=== Using the Context Objects from the Batch Runtime
 
 The batch runtime provides context objects that implement the
 `JobContext` and `StepContext` interfaces in the

src/main/asciidoc/batch-processing/batch-processing006.adoc

@@ -1,6 +1,6 @@
 [[BCGCAHCB]][[submitting-jobs-to-the-batch-runtime]]
 
-==== Submitting Jobs to the Batch Runtime
+== Submitting Jobs to the Batch Runtime
 
 The `JobOperator` interface in the `javax.batch.operations` package
 enables you to submit jobs to the batch runtime and obtain information
@@ -16,7 +16,7 @@ the `getJobOperator` factory method to obtain `JobOperator` objects.
 
 [[sthref282]][[starting-a-job]]
 
-===== Starting a Job
+=== Starting a Job
 
 The following example code demonstrates how to obtain a `JobOperator`
 object and submit a batch job:
@@ -38,7 +38,7 @@ is only known at runtime.
 
 [[BCGIBGFC]][[checking-the-status-of-a-job]]
 
-===== Checking the Status of a Job
+=== Checking the Status of a Job
 
 The `JobExecution` interface in the `javax.batch.runtime` package
 provides methods to obtain information about submitted jobs. This
@@ -60,7 +60,7 @@ String status = jobExec.getBatchStatus().toString();
 
 [[sthref283]][[invoking-the-batch-runtime-in-your-application]]
 
-===== Invoking the Batch Runtime in Your Application
+=== Invoking the Batch Runtime in Your Application
 
 The component from which you invoke the batch runtime depends on the
 architecture of your particular application. For example, you can invoke

src/main/asciidoc/batch-processing/batch-processing007.adoc

@@ -1,6 +1,6 @@
 [[BCGBBGJI]][[packaging-batch-applications]]
 
-==== Packaging Batch Applications
+== Packaging Batch Applications
 
 Job definition files and batch artifacts do not require separate
 packaging and can be included in any Jakarta EE application.