cypress-documentation icon indicating copy to clipboard operation
cypress-documentation copied to clipboard

Allow selecting older version of cypress documentation on the site

Open diggabyte opened this issue 4 years ago • 6 comments

I'm submitting a

[ ] Bug report
[ ] Content update
[X] Process update (build, deployment, ... )

Type of changes

Cypress updates are moving FAST with two major version bumps just recently. Not everyone can update and migrate all of their suites and pipelines as quickly as these versions are released.

The official docs website only presents info for the latest version. This means anyone using older versions of cypress is unable to view accurate documentation.

It would be beneficial if we could select a cypress version on the site and see the accurate, corresponding documentation.

diggabyte avatar Jul 29 '21 16:07 diggabyte

With the upgrade of Cypress 10 I'm really hoping, that you can view at least the documentation for Cypress 9.7.0. Some users still even use 8.3.1. Checking out the cypress-documentation repo, finding the correct commit (because tags are no longer maintained), and building the documentation, just to see it, seems like a hassle... altough not impossible ;-)

But I think having older documentations online would be a huge benefit for all the users...

mirobo avatar Jun 28 '22 13:06 mirobo

@diggabyte thanks for submitting this issue. This is something that we are working on internally and hope to have resolved soon.

admah avatar Jul 11 '22 19:07 admah

This is a required feature as cypress is evolving rather quickly..

Super-Chama avatar Aug 25 '22 17:08 Super-Chama

Being able to least dig for old doc versions in this repo would already be helpful.

But the git tags / branches that I see here don't correspond to any recent version? Latest tag is v3.4.1 from 2019, and most active branches don't sound version-specific...

best kludge I found so far:

  1. Git blame the changelog file to find a commit from time of release you're using.
  2. For versions before ~12.6 (pre-#5006) blame instead the release-specific file in _changelogs/ directory
  3. Click [Browse files] from the found commit...

cben avatar Jun 15 '23 09:06 cben

This seems to be helpful https://web.archive.org/web/20230000000000*/docs.cypress.io

You can match up the change-log dates with the captures here

lcombs15 avatar Sep 08 '23 14:09 lcombs15

Nerds still stuck on old versions would love this :)

matty-at-rdc avatar Feb 12 '24 18:02 matty-at-rdc