docs: add promlinter rule descriptions

Author: ldez

.golangci.next.reference.yml

@@ -2068,15 +2068,24 @@ linters-settings:
     # Please refer to https://github.com/yeya24/promlinter#usage for detailed usage.
     # Default: []
     disabled-linters:
+      # Help detects issues related to the help text for a metric.
       - Help
+      # MetricUnits detects issues with metric unit names.
       - MetricUnits
+      # Counter detects issues specific to counters, as well as patterns that should only be used with counters.
       - Counter
+      # HistogramSummaryReserved detects when other types of metrics use names or labels reserved for use by histograms and/or summaries.
       - HistogramSummaryReserved
+      # MetricTypeInName detects when metric types are included in the metric name.
       - MetricTypeInName
+      # ReservedChars detects colons in metric names.
       - ReservedChars
+      # CamelCase detects metric names and label names written in camelCase.
       - CamelCase
+      # UnitAbbreviations detects abbreviated units in the metric name.
       - UnitAbbreviations
 
+
   protogetter:
     # Skip files generated by specified generators from the checking.
     # Checks only the file's initial comment, which must follow the format: "// Code generated by <generator-name>".
@@ -2974,6 +2983,16 @@ linters-settings:
       - SA9009
 
   stylecheck:
+    # https://staticcheck.io/docs/configuration/options/#dot_import_whitelist
+    # Default: ["github.com/mmcloughlin/avo/build", "github.com/mmcloughlin/avo/operand", "github.com/mmcloughlin/avo/reg"]
+    dot-import-whitelist:
+      - fmt
+    # https://staticcheck.io/docs/configuration/options/#initialisms
+    # Default: ["ACL", "API", "ASCII", "CPU", "CSS", "DNS", "EOF", "GUID", "HTML", "HTTP", "HTTPS", "ID", "IP", "JSON", "QPS", "RAM", "RPC", "SLA", "SMTP", "SQL", "SSH", "TCP", "TLS", "TTL", "UDP", "UI", "GID", "UID", "UUID", "URI", "URL", "UTF8", "VM", "XML", "XMPP", "XSRF", "XSS", "SIP", "RTP", "AMQP", "DB", "TS"]
+    initialisms: [ "ACL", "API", "ASCII", "CPU", "CSS", "DNS", "EOF", "GUID", "HTML", "HTTP", "HTTPS", "ID", "IP", "JSON", "QPS", "RAM", "RPC", "SLA", "SMTP", "SQL", "SSH", "TCP", "TLS", "TTL", "UDP", "UI", "GID", "UID", "UUID", "URI", "URL", "UTF8", "VM", "XML", "XMPP", "XSRF", "XSS", "SIP", "RTP", "AMQP", "DB", "TS" ]
+    # https://staticcheck.io/docs/configuration/options/#http_status_code_whitelist
+    # Default: ["200", "400", "404", "500"]
+    http-status-code-whitelist: [ "200", "400", "404", "500" ]
     # STxxxx checks in https://staticcheck.io/docs/configuration/options/#checks
     # Example (to disable some checks): [ "all", "-ST1000", "-ST1003", "-ST1016", "-ST1020", "-ST1021", "-ST1022" ]
     # Default: ["*"]
@@ -3033,17 +3052,6 @@ linters-settings:
       # https://staticcheck.dev/docs/checks/#ST1023
       - ST1023
 
-    # https://staticcheck.io/docs/configuration/options/#dot_import_whitelist
-    # Default: ["github.com/mmcloughlin/avo/build", "github.com/mmcloughlin/avo/operand", "github.com/mmcloughlin/avo/reg"]
-    dot-import-whitelist:
-      - fmt
-    # https://staticcheck.io/docs/configuration/options/#initialisms
-    # Default: ["ACL", "API", "ASCII", "CPU", "CSS", "DNS", "EOF", "GUID", "HTML", "HTTP", "HTTPS", "ID", "IP", "JSON", "QPS", "RAM", "RPC", "SLA", "SMTP", "SQL", "SSH", "TCP", "TLS", "TTL", "UDP", "UI", "GID", "UID", "UUID", "URI", "URL", "UTF8", "VM", "XML", "XMPP", "XSRF", "XSS", "SIP", "RTP", "AMQP", "DB", "TS"]
-    initialisms: [ "ACL", "API", "ASCII", "CPU", "CSS", "DNS", "EOF", "GUID", "HTML", "HTTP", "HTTPS", "ID", "IP", "JSON", "QPS", "RAM", "RPC", "SLA", "SMTP", "SQL", "SSH", "TCP", "TLS", "TTL", "UDP", "UI", "GID", "UID", "UUID", "URI", "URL", "UTF8", "VM", "XML", "XMPP", "XSRF", "XSS", "SIP", "RTP", "AMQP", "DB", "TS" ]
-    # https://staticcheck.io/docs/configuration/options/#http_status_code_whitelist
-    # Default: ["200", "400", "404", "500"]
-    http-status-code-whitelist: [ "200", "400", "404", "500" ]
-
   tagalign:
     # Align and sort can be used together or separately.
     #