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

Inform user about deprecated doc #159

Open
benoittgt opened this issue Oct 18, 2020 · 4 comments
Open

Inform user about deprecated doc #159

benoittgt opened this issue Oct 18, 2020 · 4 comments

Comments

@benoittgt
Copy link
Member

Hello

When searching RSpec documentation online. I often end up on a page documentation of RSpec gems bellow 2.99.

I was thinking about the best way to mark our doc as deprecated. Few ideas:

  • Add a block to tell the reader that he/she is not on the last version with an easy link to jump to current. We can see this on PostgreSQL

Capture d’écran 2020-10-18 à 23 00 38

  • Maybe too powerful... Disable search engine indexing on old version? The best should be to change the SEO but I do not have those magic capabilities.

  • Set a new documentation for RSpec 4? VCR had a discussion.

@JonRowe
Copy link
Member

JonRowe commented Oct 19, 2020

Do you mind if we transfer this to the website repo? Seems like an issue for that? We would have to regenerate / edit the documentation to add such a banner.

@benoittgt benoittgt transferred this issue from rspec/rspec-dev Oct 19, 2020
@benoittgt
Copy link
Member Author

Yep good idea

@pirj
Copy link
Member

pirj commented Sep 29, 2023

Not a problem now with our new rspec.info, it only has 3.12
We’ll have the same issue when we release 4.0 though
Wondering why pages with more specific path have better page ranks

@JonRowe
Copy link
Member

JonRowe commented Sep 30, 2023

This refers to the rspec.info api docs, which still go back further not the cucumber docs

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

No branches or pull requests

3 participants