cypress-documentation
                                
                                 cypress-documentation copied to clipboard
                                
                                    cypress-documentation copied to clipboard
                            
                            
                            
                        Allow selecting older version of cypress documentation on the site
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.
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...
@diggabyte thanks for submitting this issue. This is something that we are working on internally and hope to have resolved soon.
This is a required feature as cypress is evolving rather quickly..
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:
- Git blame the changelog file to find a commit from time of release you're using.
- For versions before ~12.6 (pre-#5006) blame instead the release-specific file in _changelogs/ directory
- Click [Browse files] from the found commit...
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
Nerds still stuck on old versions would love this :)