Jose Enrique Ruiz

> Do you know if there is a ways to test this first? @adonath We could tag a *fake* release and then remove the tag. We will have to also...

>The ideal solution would be to: > for HTML, generate relative URLs, so that e.g. if I build the docs locally, I can browse them locally, without hitting gammapy.org This...

> But having to type https://docs.gammapy.org in the MD is annoying, and having to type a version xxx is error-prone. You don't have to type the version, just copy/paste the...

For finding broken links in notebooks I would suggest to use specific external tools made for this kind of tasks. These are the broken links that I've got using [brök](https://github.com/smallhadroncollider/brok):...

We have two alternative ways to **write from RST files, links to tutorials** as relative links. https://docs.gammapy.org/dev/development/howto.html#link-to-a-notebook-from-the-docs We have a way to **write from .ipynb files, links to doc pages...

> Another issue: if you click "Excercises" there, it takes you to https://docs.gammapy.org/0.14/notebooks/first_steps.html#Exercises which is a different section that also has the heading "Exercises" further up in the notebook. Is...

@cdeil I guess you should have a look at [Jupinx](https://sphinxcontrib-jupyter.readthedocs.io/en/latest/index.html) for the rst->ipynb approach you suggest.

@cdeil I still do no have a clear answer to this. It's true our current setup does not solve *all* the intersphinx issues, but I don't know if it's a...

@adonath In #2480 we implemented a syntax to write links in notebooks MD cells to our auto-generated API docs (classes and methods). This syntax is similar to the one we...

@adonath Yes, we can use the `nbsphinx` syntax directly in MD cells of notebooks, and we can also use the syntax exposed in https://github.com/gammapy/gammapy/pull/2480. In the case we use the...