fix: rename rule as intended to check-line-alignment

Also clean-up docs; remove examples from source (auto-generated from tests); rename rule to line-alignment

.README/README.md

@@ -480,6 +480,7 @@ selector).
 {"gitdown": "include", "file": "./rules/check-alignment.md"}
 {"gitdown": "include", "file": "./rules/check-examples.md"}
 {"gitdown": "include", "file": "./rules/check-indentation.md"}
+{"gitdown": "include", "file": "./rules/check-line-alignment.md"}
 {"gitdown": "include", "file": "./rules/check-param-names.md"}
 {"gitdown": "include", "file": "./rules/check-property-names.md"}
 {"gitdown": "include", "file": "./rules/check-syntax.md"}

.README/rules/check-line-alignment.md

@@ -0,0 +1,18 @@
+### `check-line-alignment`
+
+Reports invalid alignment of JSDoc block lines. This is a
+[standard recommended to WordPress code](https://make.wordpress.org/core/handbook/best-practices/inline-documentation-standards/javascript/#aligning-comments),
+for example.
+
+#### Options
+
+This rule allows one optional string argument. If it is `"always"` then a
+problem is raised when the lines are not aligned. If it is `"never"` then
+a problem should be raised when there is more than one space between each
+line's parts. **Only the non-default `"always"` is implemented for now.**
+
+|||
+|---|---|
+|Context|everywhere|
+|Options|(a string matching `"always"|"never"`)|
+|Tags|`param`, `arg`, `argument`, `property`, `prop`|