Add Oriol's comments

Author: AlexAndorra

docs/source/contributing/jupyter_style.md

@@ -35,7 +35,7 @@ This guide does not teach nor cover MyST extensively, only gives some opinionate
   libraries documentations. Use [sphinx cross-references](https://docs.readthedocs.io/en/stable/guides/cross-referencing-with-sphinx.html)
   instead.
 
-  * For instance, to link to another notebook, you could use an explicit link in the markdown text: "this model uses the \[Kronecker product](GP-Kron.myst.md)". See {ref}`this page <myst:syntax/targets>` for more details.
+  * For instance, to link to another notebook, you could use an explicit link in the markdown text: "this model uses the \{ref}`Kronecker product <GP-Kron>`". See {ref}`this page <myst:syntax/targets>` for more details.
 
   :::{caution}
   Using urls links breaks self referencing in versioned docs! And at the same time they are
@@ -52,27 +52,35 @@ That is, notebooks in pymc-examples referring to other notebooks in pymc-example
 
 ```
 {ref}`explicit text <anchor_id>`
-[explicit text](#anchor_id)
+```
+For instance:
+```
+{ref}`Kronecker product <GP-Kron>`
 ```
 
 #### References to targets of other projects
-These can be to any project defined in the [intersphinx mapping](https://github.com/pymc-devs/pymc-examples/blob/main/examples/conf.py#L175). For example, from pymc-examples to pymc main docs, or to arviz docs or to matplotlib docs; it doesn't matter when it comes to syntax.
+These can be to any project defined in the [intersphinx mapping](https://github.com/pymc-devs/pymc/blob/main/docs/source/conf.py#L300-L312). For example, from pymc-examples to pymc main docs, or to arviz docs or to matplotlib docs; it doesn't matter when it comes to syntax.
 
 ```
 {ref}`explicit text <key:anchor_id>`
-[explicit text](inv:key:*:ref#anchor_id)
 ```
-
-where key is one of the keys defined in the [intersphinx mapping](https://github.com/pymc-devs/pymc-examples/blob/main/examples/conf.py#L175), such as `pymc`, `arviz`, `numpy`...
+where key is one of the keys defined in the [intersphinx mapping](https://github.com/pymc-devs/pymc/blob/main/docs/source/conf.py#L300-L312), such as `pymc`, `arviz`, `numpy`...
+For instance:
+```
+{ref}`ArviZ `plot_hdi` <arviz:plot_hdi>`
+```
 
 #### References to python objects
 
 ```
 {type}`import.path`  # to show full import path
 {type}`~import.path`  # to show only object name
 ```
-
 where type is func for functions, meth for methods, class for classes, prop for property, etc.
+For instance:
+```
+{class}`~pymc.gp.HSGP`
+```
 
 Now let's continue with the MysT guidelines.