Make most arguments keyword-only, enforced by PLR0917 (#1288)

[selmanozleyen]

fixes: #1288 plus I also removed notes-dev.md as it's old. I also added some items to the contribution guide.

The ones I didn't include:

• @old_positionals on released public functions: anything in v1.8.3 keeps accepting old positional calls, with a FutureWarning.
• None on squidpy.experimental: the experimental API makes no stability promise.
• None on unreleased functions: the spatial_neighbors_* builders and the Incorporating feedback on niche refactor #1284 niche flavors have no old calls to support.
• None on private functions: internal callers were updated to pass keywords.
• calculate_niche left as is: it's deprecated and removed in v1.9.0, and a second wrapper would stack warnings.
• ImageContainer left as is: it's exempted per file until it's deprecated.

Tests changed because

• Test calls that passed now-keyword-only arguments positionally were switched to keywords, so they don't hit the FutureWarning or the TypeError.
• New test: an old positional call still works and warns (tests/utils/test_old_positionals.py).
• test_niche.py filters calculate_niche's deprecation warning, since those tests exercise the umbrella on purpose until v1.9.0. One test still asserts the warning.
• Tests are exempt from PLR0917, since pytest passes fixtures by name.

Follow-ups

• Update the tutorials in squidpy-tutorials: 17 sq.im.calculate_image_features(adata, img, …) calls and 2 sq.gr.centrality_scores(adata, "…") calls now warn.
• Remove the @old_positionals shims in v1.9.0.
• Deal with ImageContainer when it's deprecated; it's currently exempt from the rule per file.
• Replace the deprecated skimage, pandas and anndata calls in src (binary_closing, square, area_threshold, skimage.io plugins, pandas copy=, uns_keys).

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 78.70%. Comparing base (69a3bea) to head (f9e4f2c).

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1297      +/-   ##
==========================================
+ Coverage   78.63%   78.70%   +0.07%     
==========================================
  Files          64       64              
  Lines        9620     9652      +32     
  Branches     1616     1616              
==========================================
+ Hits         7565     7597      +32     
  Misses       1498     1498              
  Partials      557      557              

Files with missing lines	Coverage Δ
src/squidpy/_compat.py	75.00% <100.00%> (+1.66%)	⬆️
src/squidpy/_utils.py	72.00% <ø> (ø)
...uidpy/experimental/im/_calculate_image_features.py	89.42% <100.00%> (ø)
src/squidpy/experimental/im/_detect_tissue.py	67.77% <ø> (ø)
src/squidpy/experimental/im/_make_tiles.py	73.97% <ø> (ø)
src/squidpy/experimental/im/_qc_image.py	82.48% <100.00%> (ø)
src/squidpy/experimental/im/_stain/_normalize.py	93.75% <ø> (ø)
src/squidpy/experimental/im/_utils.py	67.26% <ø> (ø)
src/squidpy/experimental/pl/_qc_image.py	60.22% <ø> (ø)
src/squidpy/experimental/pl/_tiling_qc.py	64.70% <ø> (ø)
... and 20 more

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.