Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation of previous versions missing #8634

Closed
2 tasks done
dharsanb opened this issue Feb 5, 2023 · 5 comments
Closed
2 tasks done

Documentation of previous versions missing #8634

dharsanb opened this issue Feb 5, 2023 · 5 comments
Labels
documentation The issue is related to the documentation of Docusaurus external This issue is caused by an external dependency and not Docusaurus.

Comments

@dharsanb
Copy link
Contributor

dharsanb commented Feb 5, 2023

Have you read the Contributing Guidelines on issues?

Description

Documentation links in the Versions page have expired. Either they must say documentation not available or not display the versions anymore. Eg: Version 2.0.0-beta.22 points to Netlify link which does not exist.

Self-service

  • I'd be willing to address this documentation request myself.
@dharsanb dharsanb added documentation The issue is related to the documentation of Docusaurus status: needs triage This issue has not been triaged by maintainers labels Feb 5, 2023
@Josh-Cena
Copy link
Collaborator

Interesting, I wonder if anything happened to Netlify's storage of snapshots.

@Josh-Cena Josh-Cena added external This issue is caused by an external dependency and not Docusaurus. and removed status: needs triage This issue has not been triaged by maintainers labels Feb 7, 2023
@slorber
Copy link
Collaborator

slorber commented Feb 15, 2023

Hmmm that's really annoying 😓 will contact Netlify support to see what is happening.

@slorber
Copy link
Collaborator

slorber commented Feb 15, 2023

Apparently, the React website was probably also affected by this issue.

They also used such permalinks before for older versions, which are all offline now: https://17.reactjs.org/versions)
Older Netlify deployment permalinks were removed in reactjs/react.dev#4482 (versions.yml file diff)

CleanShot 2023-02-15 at 19 04 51@2x

@slorber
Copy link
Collaborator

slorber commented Feb 16, 2023

Apparently, it's a Netlify deployment retention policy change from a few months ago:
https://www.netlify.com/blog/automated-deploy-cleanup-and-new-deploy-retention-policies/

There's no way to restore those deployments 😅
In our cases, those are alpha/beta/rc so we can probably just delete them, although I understand it can be annoying for some users that are still using older versions.

But it's a problem for the future because our versioned deployment strategy now does not work anymore. I configured the retention to the max value of 365 days but it's only a temporary workaround, and we can't archive 2.0.1 with that policy. Will have to figure out a new archiving process, probably requiring the creation of a docs archive git branch. We'll see how to do that once we will archive 2.0.1.

@slorber
Copy link
Collaborator

slorber commented Sep 18, 2023

Note: I'm waiting for an answer from someone at Meta to see how we decide to archive older versions for Meta open-source sites.

The archiving process options I proposed are described on the React-Native-Website repo here: facebook/react-native-website#3819

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation The issue is related to the documentation of Docusaurus external This issue is caused by an external dependency and not Docusaurus.
Projects
None yet
Development

No branches or pull requests

3 participants