[CI] Textlint: properly check for Java capitalization & more (open-telemetry#3497)

Author: chalin

.textlintrc.json

@@ -1,6 +1,6 @@
 {
   "plugins": {
-    "@textlint/text": {
+    "@textlint/markdown": {
       "extensions": [".yml"]
     }
   },
@@ -20,8 +20,7 @@
         "Open Agent Management Protocol",
         "SignalFx Smart Agent",
         "/^(?:language|repo): .*$/m",
-        "/tags:([\\n\\r\\s]*-[\\s\\S]*?[\\n\\r]+)*/m",
-        "/\\.java\\b/"
+        "/^tags:(\\s*-.+$)*/m"
       ]
     }
   },
@@ -54,7 +53,6 @@
         "HTTP",
         "HTTPS",
         "Jaeger",
-        "Java",
         "JavaScript",
         "JBoss",
         "Jetty",
@@ -115,6 +113,7 @@
         ["he/she", "they"],
         ["\\(s\\)he", "they"],
         ["id['’]?s", "IDs"],
+        ["(?<![.-])java\\b(?![.])", "Java"],
         ["java[- ]?agent", "Java agent"],
         ["mac ?os", "macOS"],
         ["meta[- ]data", "metadata"],

content/en/blog/2022/debug-otel-with-otel/index.md

@@ -44,7 +44,7 @@ application.
 ### Steps to reproduce
 
 Follow the instructions on how you can [put NGINX between two services][].
-Replace the java-based application with a Python application, e.g. put following
+Replace the Java-based application with a Python application, e.g. put following
 three files into the `backend` folder instead:
 
 - `app.py`:

content/en/docs/instrumentation/java/manual.md

@@ -199,9 +199,13 @@ dependencies {
 }
 ```
 
-Throughout this documentation you will add additional dependencies. For a full
-list of artifact coordinates see [releases][releases] and for semantic
-convention releases see [semantic-conventions-java][semantic-conventions-java].
+Throughout this documentation you will add dependencies. For a full list of
+artifact coordinates, see [releases]. For semantic convention releases, see
+[semantic-conventions-java].
+
+[releases]: https://github.com/open-telemetry/opentelemetry-java#releases
+[semantic-conventions-java]:
+  https://github.com/open-telemetry/semantic-conventions-java/releases
 
 {{% /tab %}} {{% tab Maven %}}
 
@@ -1652,8 +1656,5 @@ io.opentelemetry.sdk.trace.export.BatchSpanProcessor = io.opentelemetry.extensio
 [opentelemetry registry]: /ecosystem/registry/?component=exporter&language=java
 [parentbased]:
   https://github.com/open-telemetry/opentelemetry-java/blob/main/sdk/trace/src/main/java/io/opentelemetry/sdk/trace/samplers/ParentBasedSampler.java
-[releases]: https://github.com/open-telemetry/opentelemetry-java#releases
-[semantic-conventions-java]:
-  https://github.com/open-telemetry/semantic-conventions-java/releases
 [traceidratiobased]:
   https://github.com/open-telemetry/opentelemetry-java/blob/main/sdk/trace/src/main/java/io/opentelemetry/sdk/trace/samplers/TraceIdRatioBasedSampler.java