DOC - Enable viewing dev and stable versions of package documentation

[Badr-MOUFAD]

Context of the PR

Currently, it is impossible for a user to view the documentation of the stable version 0.3.
As we keep updating the package (new features, bugs, ...) the dev version of the doc diverges from the stable one.

A brief preview of this PR contribution

Close #203

Contributions of the PR

• add a version toggler to switch between the dev and stable versions of the package documentation

Checks before merging PR

• [ ] added documentation for any new feature
• [ ] added unittests
• [ ] edited the what's new

[mathurinm]

Thanks @Badr-MOUFAD ! On the CI build I get an error for https://output.circle-artifacts.com/output/job/724f72b1-185b-41e9-93cb-680e9da6ba85/artifacts/0/dev/stable/index.html when clicking on "stable version", is it normal ?

[Badr-MOUFAD]

Thanks @Badr-MOUFAD ! On the CI build I get an error for https://output.circle-artifacts.com/output/job/724f72b1-185b-41e9-93cb-680e9da6ba85/artifacts/0/dev/stable/index.html when clicking on "stable version", is it normal ?

Yes @mathurinm, it is normal to not see the stable version.
We haven't uploaded it yet, and if so, it won't appear in the artifacts as we expose only the dev version in Circleci.

[mathurinm]

How do you think we should test this? Do you add the stable folder in this PR?

[Badr-MOUFAD]

How do you think we should test this? Do you add the stable folder in this PR?

I exposed the stable doc skglm v0.3 in the artifact, (beforehand, I built it and pushed it to gh-pages)
Now, we have a mirror of what will be deployed to the website

[mathurinm]

@Badr-MOUFAD maybe move it above as it contains important information? otherwise looking great!

[Badr-MOUFAD]

Doing so, +small adjustments, we get this render

Looks great @mathurinm, 👍 for this change

[mathurinm]

@PABannier this should fix the issue you had, thanks @Badr-MOUFAD !

[PABannier]

Thanks @Badr-MOUFAD !