Add articles to /java/developer-guide/complex-barcode/ section

Author: Aleksander Grinin

java/developer-guide/complex-barcode/_index.md

@@ -2,7 +2,7 @@
 title: "Complex Barcode"
 description: "Learn how to generate, read, decode, and troubleshoot structured complex barcodes with Aspose.BarCode for Java."
 type: docs
-weight: 40
+weight: 60
 url: /java/developer-guide/complex-barcode/
 ---
 

java/developer-guide/complex-barcode/examples/_index.md

@@ -2,7 +2,7 @@
 title: "Complete Complex Barcode Examples"
 description: "Explore complete end-to-end workflows for generating, recognizing, decoding, and validating complex barcodes."
 type: docs
-weight: 40
+weight: 50
 url: /java/developer-guide/complex-barcode/examples/
 ---
 

java/developer-guide/complex-barcode/supported_types/_index.md

@@ -2,7 +2,7 @@
 title: "Supported Complex Barcode Types"
 description: "Explore the complex barcode standards supported by Aspose.BarCode for Java."
 type: docs
-weight: 50
+weight: 40
 url: /java/developer-guide/complex-barcode/supported_types/
 ---
 

java/developer-guide/complex-barcode/supported_types/usa_driver_id/_index.md

@@ -28,79 +28,109 @@ codetext.setNumberOfEntries(1);
 codetext.setSubfileDesignator(
         List.of(
                 new USADriveIdCodetext
-                        .SubfileProperties("DL")
+                .SubfileProperties("DL")
         )
-);
+                );
 ```
 
 ## Configure mandatory fields
 
+The mandatory AAMVA data includes identity, document, address, physical-description, and truncation fields. The following example matches the complete set used in the related TestNG class.
+
 ```java
 USADriveIdCodetext.MandatoryFields fields =
         new USADriveIdCodetext.MandatoryFields();
 
 fields.setVehicleClass("C");
-fields.setExpirationDate(
-        LocalDate.of(2030, 12, 31)
-);
+fields.setRestrictionCodes("NONE");
+fields.setEndorsementCodes("NONE");
+
+fields.setExpirationDate(LocalDate.of(2030, 12, 31));
+
 fields.setFamilyName("DOE");
 fields.setFirstName("JOHN");
-fields.setDateOfBirth(
-        LocalDate.of(1990, 5, 20)
-);
+fields.setMiddleName("Q");
+
+fields.setIssueDate(LocalDate.of(2026, 1, 1));
+
+fields.setDateOfBirth(LocalDate.of(1990, 5, 20));
+
 fields.setSex(USADriveIdSex.MALE);
-fields.setEyeColor(
-        USADriveIdEyeColor.BROWN
-);
+fields.setEyeColor(USADriveIdEyeColor.BROWN);
+fields.setHeight("070 in");
+
+fields.setAddressStreet1("123 MAIN STREET");
+fields.setAddressCity("ANYTOWN");
 fields.setAddressState("CA");
+fields.setAddressPostalCode("90210");
+
 fields.setCustomerIDNumber("D1234567");
+fields.setDocumentDiscriminator("DOC123456789");
+
+fields.setCountryIdentification(USADriveIdCountry.US);
+
+fields.setFamilyNameTruncation("N");
+fields.setFirstNameTruncation("N");
+fields.setMiddleNameTruncation("N");
 
 codetext.setMandatoryElements(fields);
 ```
 
+These values are serialized into the AAMVA data structure before the PDF417 carrier is generated.
+
 ## Configure optional fields
 
 ```java
 USADriveIdCodetext.OptionalFields optional =
         new USADriveIdCodetext.OptionalFields();
 
-optional.setHairColor(
-        USADriveIdHairColor.BROWN
-);
+optional.setHairColor(USADriveIdHairColor.BROWN);
 optional.setOrganDonorIndicator("1");
 
 codetext.setOptionalElements(optional);
 ```
 
+Optional fields extend the cardholder data without replacing the mandatory AAMVA elements.
+
 ## Generate the PDF417 carrier
 
 ```java
-ComplexBarcodeGenerator generator =
-        new ComplexBarcodeGenerator(codetext);
+ComplexBarcodeGenerator generator = new ComplexBarcodeGenerator(codetext);
 
-generator.save(
-        "usa_driver_id.png",
-        BarCodeImageFormat.PNG
-);
+generator.save("usa_driver_id.png",BarCodeImageFormat.PNG);
 ```
 
-Recognize the result with `DecodeType.PDF_417`.
+Recognize the generated image with `DecodeType.PDF_417`.
+
+```java
+BarCodeReader reader = new BarCodeReader("usa_driver_id.png",DecodeType.PDF_417);
+
+BarCodeResult[] results = reader.readBarCodes();
+```
 
 ## Decode Driver ID data
 
 ```java
-USADriveIdCodetext decoded =
-        ComplexCodetextReader.tryDecodeUSADriveId(
-                results[0].getCodeText()
-        );
+USADriveIdCodetext decoded = ComplexCodetextReader.tryDecodeUSADriveId(results[0].getCodeText());
+```
+
+After decoding, the mandatory and optional objects can be accessed directly.
+
+```java
+String familyName = decoded.getMandatoryElements().getFamilyName();
+
+String documentNumber = decoded.getMandatoryElements().getCustomerIDNumber();
+
+USADriveIdHairColor hairColor = decoded.getOptionalElements().getHairColor();
 ```
 
-Validate issuer, AAMVA version, identity, document, address, physical-description, and optional cardholder fields.
+Validate issuer, AAMVA version, identity, document, address, physical-description, truncation, and optional cardholder fields.
 
 ## Recommendations
 
-- Populate every mandatory AAMVA field.
+- Populate every mandatory AAMVA field required by the selected format.
 - Use the correct AAMVA and jurisdiction versions.
-- Preserve required field formats.
+- Preserve required date, height, address, and document formats.
+- Set truncation indicators explicitly when required by the data format.
 - Recognize the carrier as PDF417.
-- Validate mandatory and optional decoded fields.
+- Validate both mandatory and optional decoded fields.