Example of Pull Request with diff image to prove that content of examples is same #18505

please share diff.

not clear why you removed method that is target forjavadoc

https://www.diffchecker.com/tmg7tNi2/
Example 1 vs Example 4.pdf
The reason for removal of testmethod 3 to match Example4 Ast to Example1.
The code of Example1 and Example4 were same.

please put

   * @tag comment
   *     Indentation spacing is 4

and similar tags from exmaple1-3 to exmple4

make Exmaple1-3 as example4.

Diff should be minimal as I shared in example

@romani,
make Exmaple1-3 as example4 ?
should i make Example1,2,3 as Example4 by adding testmethod3() ?
And Add these tags inside Example4 from Example1,2,3?

You can do everything to make them the same.

https://www.diffchecker.com/Ip67wmBp/
I Updated Example 1,2,3 to look like Example 4 by adding testmethod3.
The example4 javadoc is different is because as it explaining pre and code tag.

{} should be for all methods.
Please make all examples the same, just merge all example snippets to single java file.

Only and only comments o violations should be different

GitHub, generate website

Please share diffchecker links to speed up review

https://www.diffchecker.com/X8i8BYcO/
https://www.diffchecker.com/uRQutKrO/
https://www.diffchecker.com/6NJbIi9e/
Here is diffchecker of Example1 vs Example2 and Example1 vs Example3 and Example1 vs 4.
The javadoc of example4 is different because it show pre and code tag.
The code of all example is same only comments are different.

@romani ,
Here is overall diff. Please let me know if any changes are required

https://www.diffchecker.com/X8i8BYcO/ https://www.diffchecker.com/uRQutKrO/ https://www.diffchecker.com/6NJbIi9e/ Here is diffchecker of Example1 vs Example2 and Example1 vs Example3 and Example1 vs 4. The javadoc of example4 is different because it show pre and code tag. The code of all example is same only comments are different.

GitHub, generate website

Examples must be same, please copy methods with big javadoc from Example 4 all other Examples.
Differences should be only in violation comments.

example 1 vs 3

please avoid 1 and 2 , just keep Attention to Indentation spacing

https://checkstyle-diff-reports.s3.us-east-2.amazonaws.com/fd8315d_20260116140213/index.html

https://checkstyle-diff-reports.s3.us-east-2.amazonaws.com/fd8315d_20260116140213/checks/javadoc/javadoctagcontinuationindentation.html#Examples

@romani,
https://www.diffchecker.com/86Ky19Zm/
https://www.diffchecker.com/6bLkawxW/
https://www.diffchecker.com/ltke2iM6/

I compare all the examples by using diffchecker all the Examples are same.
All the code and javadoc is same in all the examples in diffcheck.
only violation comments are different as they explain violation.
please let me know if any other changes are required in examples.

GitHub, generate website

https://checkstyle-diff-reports.s3.us-east-2.amazonaws.com/336646c_20260122160237/index.html

https://checkstyle-diff-reports.s3.us-east-2.amazonaws.com/336646c_20260122160237/checks/javadoc/javadoctagcontinuationindentation.html#Examples

No diff. Please.

Now, all Examples 1–4 use the same set of methods and Javadoc.
Only violation comments different.
I removed the extra method like testIndentation1, testIndentation2 etc to follow the Xdocs AST consistency requirement.
I checked all the Examples by using diffchecker the code and javadoc are all same now.

GitHub, generate website

please share diffchecker links after website is generated.
Lets merge this PR sooner.

https://checkstyle-diff-reports.s3.us-east-2.amazonaws.com/63ab1eb_20260123134738/index.html

https://checkstyle-diff-reports.s3.us-east-2.amazonaws.com/63ab1eb_20260123134738/checks/javadoc/javadoctagcontinuationindentation.html#Examples

@romani,
https://www.diffchecker.com/3bWzmxpH/
https://www.diffchecker.com/xw49BlZL/
https://www.diffchecker.com/KWgsr6Ab/
Here is diffchecker links of all the Examples.All the Examples are same now.

Javadoc is code here it should be same.
If you need two different indentations, please create two methods+javadoc.

Now all the Javadoc code is same. created two methods in All the Example one for default and one for violation.
the only difference is Violation comments and config in all example.

@romani,
https://www.diffchecker.com/FOY0keNx/
https://www.diffchecker.com/Sui4gGUH/
https://www.diffchecker.com/RG9Excgn/
Here is the updated diffchecker links for all the Examples.
Please let me know if any other changes are required.

GitHub, generate website

https://checkstyle-diff-reports.s3.us-east-2.amazonaws.com/b8f9ffd_20260124054241/index.html

https://checkstyle-diff-reports.s3.us-east-2.amazonaws.com/b8f9ffd_20260124054241/checks/javadoc/javadoctagcontinuationindentation.html#Examples

@ZaheerAhmadDev , please do not rebase PR constantly, if you have nothing to change, do not touch it, to let me see that all report generated on latest code and nothing is missing.

@ZaheerAhmadDev , thanks a lot for your big effort on this.
I placed your PR as example for others on how to do this update.

can I ask you to do one more fix for #18435 to make sure you can do it from single try.

If you can help us to improve workding of issue description, it would be awesome