✔️ Linting Passed

All linting checks passed. Your pull request is in excellent shape! ☀️

_{Generated for commit: a395123. Link to the linter CI: here}

Hello @lc542,

thank you for your contribution.

As part of triaging it, I looked through the repo and found these examples are already heavily referenced in the user guide: I found references containing plot_nca_ 8 times in neighbors.rst and the references you added in _nca.py are pretty general. We have been discussing cases like these and we have decided that especially in the docstrings, we want to have real usability improvements from added references, since we already have the examples gallery on the bottom of the page.

This is why I think it is best to close your PR, since - through your contribution - we found out that we don't need to further add references to these three examples. Thank you for making the effort and helping us to come to a conclusion about these examples.

For expectation management I have just added this section on the issue description:

Important: We estimate that only 70% of the examples in this list will ultimately be referenced. This means part of the task is deciding which examples deserve being referenced and we are aware that this is not a trivial decision, especially for new contributors. We encourage you to share your reasoning, and a team member will make the final call. We hope this isn’t too frustrating, but please know that evaluating an example is not just an exercise for new contributors; it’s a meaningful and valuable contribution to the project, even (and especially) if the example you worked on doesn’t end up being referenced.

I hadn't been there when you started your PR, so I wanted to draw your attention to it.

Thank you for your effort and your valuable contribution!

Please feel free to pick another example or contribute in a different issue.