Updated a few links

[MegaIng]

I believe that the changed link from examples to /examples isn't a problem on readthedocs, but we should check. If it works, this PR fixes #941 .

[erezsh]

You can run make on the docs folder to build them and see for yourself.

[MegaIng]

@erezsh I am not a 100% sure this will work. The question is how readthedocs deals with rooted links. I would in theory expect him to redirect to latest, but I don't know if it will do that.

[MegaIng]

Ok, I just did find something I can test this with. It probably won't work. But I am not sure if there is a nice solution except restructuring the docs.

[erezsh]

I don't see how restructuring the docs will help?

The only solution I can think of is interface with sphinx-examples and change the way it produces links.

[erezsh]

But if it works when you run make and view it statically, it will probably work on readthedocs.

[MegaIng]

Unless readthedocs does page rewriting (which I don't think they do), the final link will be https://lark-parser.readthedocs.io/examples/, which is a 404. It work's locally with a http server served from _build/html, but that is not the actual root on RTD.

[MegaIng]

But this looks good: https://docs.readthedocs.io/en/latest/user-defined-redirects.html

[MegaIng]

Can you try to merge this Pr and rebuild readthedocs and test if it works? If not, I think the best solution is to use an Exact redirect like this:

Type: Exact Redirect
From URL: /examples
To URL:   /en/latest/examples

While not ideal (on old versions it will still link to the latest), I think it is the best we are going to get.

[erezsh]

404

Try your idea.

[MegaIng]

@erezsh You need to follow the steps here.

[erezsh]

Funny, even their example uses the examples directory.

[erezsh]

It works. Nice one!