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

Meta Depreaction #2172

Merged
merged 11 commits into from
Aug 28, 2024
Merged

Meta Depreaction #2172

merged 11 commits into from
Aug 28, 2024

Conversation

kianenigma
Copy link
Contributor

@kianenigma kianenigma commented Aug 27, 2024

This takes a big step towards deprecating a lot of the content here.

Everything is still accessible, no URL has changed, but you would have to first see the deprecation page.

The docs homepage now looks like this:

Screenshot 2024-08-27 at 15 14 45

Once you click on it, you land on this page with further explanation, and access to all the old content in the navbar:

Screenshot 2024-08-27 at 15 15 52

And a single page looks like this:

Screenshot 2024-08-27 at 13 07 33

Copy link

netlify bot commented Aug 27, 2024

Deploy Preview for substrate-docs ready!

Name Link
🔨 Latest commit 5ed84fd
🔍 Latest deploy log https://app.netlify.com/sites/substrate-docs/deploys/66cf4228e4780b0008a56d50
😎 Deploy Preview https://deploy-preview-2172--substrate-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

src/pages/index.js Outdated Show resolved Hide resolved
content/md/en/docs/polkadot-sdk/index.md Outdated Show resolved Hide resolved
content/md/en/docs/polkadot-sdk/index.md Outdated Show resolved Hide resolved
content/md/en/docs/polkadot-sdk/index.md Outdated Show resolved Hide resolved
content/md/en/docs/polkadot-sdk/index.md Outdated Show resolved Hide resolved
content/md/en/docs/polkadot-sdk/index.md Outdated Show resolved Hide resolved
content/md/en/docs/polkadot-sdk/index.md Outdated Show resolved Hide resolved
content/md/en/docs/polkadot-sdk/index.md Outdated Show resolved Hide resolved
content/md/en/docs/polkadot-sdk/index.md Outdated Show resolved Hide resolved
Copy link
Contributor

@CrackTheCode016 CrackTheCode016 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Super tiny nits, looks good to me!

content/md/en/docs/polkadot-sdk/index.md Outdated Show resolved Hide resolved
content/md/en/docs/polkadot-sdk/index.md Outdated Show resolved Hide resolved
Copy link
Contributor

@shawntabrizi shawntabrizi left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i am fine with this as a first step, but I am def inclined to actually start deleting more content overall :)

I am not sure the best look either is to have docs which are all "deprecated" everywhere. Looks like we are dying.

@kianenigma
Copy link
Contributor Author

That's a great point, I will rework the use of the word "deprecated", I agree it has too much of a negative connotation.

I can call it more positive things like "upgrade", "new era", and such.

@shawntabrizi
Copy link
Contributor

shawntabrizi commented Aug 27, 2024

@kianenigma truthfully the answer to me is to just delete the content.

Content which does not work or is not updated is just noise.

I think we must look to figure out what content we actually want to keep, maintain, and then just make sure those links exist, and are maintained

That being said, i don't want to hijack this PR and add a bunch more work. I think this is a fine first step

@rmnprkrl
Copy link
Collaborator

@mordamax took over the website/infra on the paritytech side and hopefully could help you.

@kianenigma
Copy link
Contributor Author

@kianenigma truthfully the answer to me is to just delete the content.

Content which does not work or is not updated is just noise.

I think we must look to figure out what content we actually want to keep, maintain, and then just make sure those links exist, and are maintained

That being said, i don't want to hijack this PR and add a bunch more work. I think this is a fine first step

Indeed, Papermoon and W3F have started this process, and afaik are quite far in it. I have also provided some degree of help to them toward this goal.

I will remove the negative "deprecated" word, then proceed with merging this.


@mordamax can you help with providing some kind of a minimal ribbon/banner in the main substrate website, that is visible in all pages, and forward everyone to docs.substrate.io/polkadot-sdk? This can happen next.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants