🐛 Fix linkcheck CI job warnings (useblocks#1667)

`tox -e docs-linkcheck` fails due to 4 warnings promoted to errors by
`-W` flag.

- **`docs/directives/needbar.rst`**: Fix 3 duplicate target name
"transpose" errors — the named hyperlink `` `transpose <...>`_ ``
conflicted with the section heading target. Changed to anonymous
reference (`` `transpose <...>`__ ``).
- **`docs/utils.rst`**: Remove duplicate toctree entry for
`performance/debug`, already included via `performance/index`.
- **`docs/conf.py`**: Add `("py:class", "dict[str")` to `nitpick_ignore`
for a malformed autodoc-generated type reference.

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: ubmarco <839934+ubmarco@users.noreply.github.com>

Author: Copilot

docs/conf.py

@@ -52,6 +52,7 @@
     ("py:class", "sphinx_needs.config.NeedsSphinxConfig"),
     ("py:class", "AllowedTypes"),
     ("py:class", "FieldSchemaTypes"),
+    ("py:class", "dict[str"),  # malformed type ref generated by autodoc
 ]
 
 rst_epilog = """

docs/directives/needbar.rst

@@ -288,7 +288,7 @@ The ``:horizontal:`` flag does not support any values and it's useful with the `
 transpose
 ~~~~~~~~~
 
-You can `transpose <https://en.wikipedia.org/wiki/Transpose>`_ the data in the content by setting the ``:transpose:`` flag.
+You can `transpose <https://en.wikipedia.org/wiki/Transpose>`__ the data in the content by setting the ``:transpose:`` flag.
 The idea is, you can try to see the data from different point of view, without refactoring.
 
 The ``:transpose:`` flag does not support any values and it's useful with big content tables.

docs/utils.rst

@@ -7,4 +7,3 @@ Utils
    :maxdepth: 2
 
    performance/index
-   performance/debug