fix: griffe warnings about .md links; refactoring text.

Author: janfb

docs/docs/contribute.md

@@ -179,19 +179,22 @@ to also run them without `-n auto`.
 When you create a PR onto `main`, our Continuous Integration (CI) actions on
 GitHub will perform the following checks:
 
-- **`ruff`** for linting and formatting (including `black`, `isort`, and `flake8`)
+- **[`ruff`](https://docs.astral.sh/ruff/formatter/)** for linting and formatting
+  (including `black`, `isort`, and `flake8`)
 - **[`pyright`](https://github.com/Microsoft/pyright)** for static type checking.
-- **`pytest`** for running a subset of fast tests from our test suite.
+- **[`pytest`](https://docs.pytest.org/en/stable/index.html)** for running a subset of
+  fast tests from our test suite.
 
 If any of these fail, try reproducing and solving the error locally:
 
-- **`ruff`**: Make sure you have `pre-commit` installed locally with the same
- version as specified in the [requirements](pyproject.toml). Execute it
- using `pre-commit run --all-files`. `ruff` tends to give informative error
-  messages that help you fix the problem. Note that pre-commit only detects
-  problems with `ruff` linting and formatting, but does not fix them. You can
-  fix them either by running `ruff check . --fix(linting)`, followed by
-  `ruff format . --fix(formatting)`, or by hand.
+- **`ruff`**: Make sure you have `pre-commit` installed locally with the same version as
+ specified in the
+ [`pyproject.toml`](https://github.com/sbi-dev/sbi/blob/main/pyproject.toml). Execute it
+  using `pre-commit run --all-files`. `ruff` tends to give informative error messages
+  that help you fix the problem. Note that pre-commit only detects problems with `ruff`
+  linting and formatting, but does not fix them. You can fix them either by running
+  `ruff check . --fix(linting)`, followed by `ruff format . --fix(formatting)`, or by
+  hand.
 - **`pyright`**: Run it locally using `pyright sbi/` and ensure you are using
 the same
   `pyright` version as used in the CI (which is the case if you have installed

docs/docs/faq.md

@@ -7,3 +7,7 @@
 5. [How should I save and load objects in `sbi`?](faq/question_05_pickling.md)
 6. [Can I stop neural network training and resume it later?](faq/question_06_resume_training.md)
 7. [How can I use a prior that is not defined in PyTorch?](faq/question_07_custom_prior.md)
+
+See also [discussion page](https://github.com/sbi-dev/sbi/discussions) and [issue
+tracker](https://github.com/sbi-dev/sbi/issues) on the `sbi` GitHub repository for
+recent questions and problems.

docs/docs/index.md

@@ -45,7 +45,7 @@ Then, check out our material:
 -  :rocket: [__Tutorials and Examples__](tutorials/index.md)
    <br/><br/>
    *Various examples illustrating how to<br/> [get
-   started](tutorials/00_getting_started_flexible/) or use the `sbi` package.*
+   started](tutorials/00_getting_started_flexible.md) or use the `sbi` package.*
 
 -  :building_construction: [__Reference API__](reference/index.md)
    <br/><br/>
@@ -124,7 +124,7 @@ the inference on one particular observation to be more simulation-efficient
 Below, we list all implemented methods and the corresponding publications. To see
 how to access these methods in `sbi`, check out our [Inference API's reference](
 reference/inference.md) and the [tutorial on implemented
-methods](tutorials/16_implemented_methods.ipynb).
+methods](tutorials/16_implemented_methods.md).
 
 ### Posterior estimation (`(S)NPE`)
 

docs/docs/tutorials/index.md

@@ -15,42 +15,45 @@ inference.
 ## Introduction
 
 <div class="grid cards" markdown>
-- [Getting started](00_getting_started_flexible)
-- [Amortized inference](01_gaussian_amortized)
-- [Implemented algorithms](16_implemented_methods)
+- [Getting started](00_getting_started_flexible.md)
+- [Amortized inference](01_gaussian_amortized.md)
+- [Implemented algorithms](16_implemented_methods.md)
 </div>
 
 ## Advanced
 
 <div class="grid cards" markdown>
-- [Multi-round inference](03_multiround_inference)
-- [Sampling algorithms in sbi](11_sampler_interface)
-- [Custom density estimators](04_density_estimators)
-- [Embedding nets for observations](05_embedding_net)
-- [SBI with trial-based data](14_iid_data_and_permutation_invariant_embeddings)
-- [Handling invalid simulations](08_restriction_estimator)
-- [Crafting summary statistics](10_crafting_summary_statistics)
+- [Multi-round inference](03_multiround_inference.md)
+- [Sampling algorithms in sbi](11_sampler_interface.md)
+- [Custom density estimators](04_density_estimators.md)
+- [Embedding nets for observations](05_embedding_net.md)
+- [SBI with trial-based data](14_iid_data_and_permutation_invariant_embeddings.md)
+- [Handling invalid simulations](08_restriction_estimator.md)
+- [Crafting summary statistics](10_crafting_summary_statistics.md)
+- [Importance sampling posteriors](17_importance_sampled_posteriors.md)
 </div>
 
 ## Diagnostics
 
 <div class="grid cards" markdown>
-- [Posterior predictive checks](12_diagnostics_posterior_predictive_check)
-- [Simulation-based calibration](13_diagnostics_simulation_based_calibration)
-- [Density plots and MCMC diagnostics with ArviZ](15_mcmc_diagnostics_with_arviz)
+- [Posterior predictive checks](12_diagnostics_posterior_predictive_check.md)
+- [Simulation-based calibration](13_diagnostics_simulation_based_calibration.md)
+- [Density plots and MCMC diagnostics with ArviZ](15_mcmc_diagnostics_with_arviz.md)
+- [Local-C2ST coverage checks](18_diagnostics_lc2st.md)
 </div>
 
 
 ## Analysis
 
 <div class="grid cards" markdown>
-- [Conditional distributions](07_conditional_distributions)
-- [Posterior sensitivity analysis](09_sensitivity_analysis)
+- [Conditional distributions](07_conditional_distributions.md)
+- [Posterior sensitivity analysis](09_sensitivity_analysis.md)
+- [Plotting functionality](19_plotting_functionality.md)
 </div>
 
 ## Examples
 
 <div class="grid cards" markdown>
-- [Hodgkin-Huxley model](../examples/00_HH_simulator)
-- [Decision-making model](../examples/01_decision_making_model)
+- [Hodgkin-Huxley model](../examples/00_HH_simulator.md)
+- [Decision-making model](../examples/01_decision_making_model.md)
 </div>