Fix nitpick ignore regexes; extend until they pass

The nitpick ignore regex list included `pip.*`. Because this is a simple
regex match, it matches `piptools...` as well as `pip...`.

Fixing the regex to be correctly scoped reveals many nitpick errors
inside of piptools, which are suppressed here in order to make it
possible to track them down and fix later.

In addition to generally fixing the regexes,

- `InvalidName` and `NormalizedName`, from within `packaging`, are added
  to nitpick ignores

- the regexes are sorted and organized into sections

Author: sirosen

changelog.d/+fcb3437a.contrib.md

@@ -0,0 +1 @@
+Fixed incorrect nitpick ignore regexes -- by {user}`sirosen`.

docs/conf.py

@@ -95,16 +95,24 @@
 ]
 
 nitpick_ignore_regex = [
-    ("py:class", "pip.*"),
-    ("py:class", "pathlib.*"),
-    ("py:class", "click.*"),
-    ("py:class", "build.*"),
-    ("py:class", "optparse.*"),
-    ("py:class", "_ImportLibDist"),
-    ("py:class", "PackageMetadata"),
-    ("py:class", "importlib.*"),
+    # FIXME: broken refs inside of pip-tools itself
+    # internal names with leading '_', mostly type vars
+    ("py:.*", r"piptools\..*\._\w+"),
+    # BaseRepository ref is broken?
+    ("py:class", r"piptools\.repositories\.BaseRepository"),
+    # external libraries
+    ("py:.*", r"click\..*"),
+    ("py:.*", r"pip\..*"),
+    ("py:class", "NormalizedName"),
+    ("py:exc", "InvalidName"),
     ("py:class", "IndexContent"),
-    ("py:exc", "click.*"),
+    ("py:class", "PackageMetadata"),
+    ("py:class", "_ImportLibDist"),
+    ("py:class", r"build\..*"),
+    # stdlib
+    ("py:class", r"importlib\..*"),
+    ("py:class", r"optparse\..*"),
+    ("py:class", r"pathlib\..*"),
 ]
 
 suppress_warnings = [