rspec.github.io icon indicating copy to clipboard operation
rspec.github.io copied to clipboard
verified publisher icon rspec

Inform user about deprecated doc

Open benoittgt opened this issue 5 years ago • 4 comments

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.

benoittgt avatar Oct 18 '20 21:10 benoittgt

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.

JonRowe avatar Oct 19 '20 10:10 JonRowe

Yep good idea

benoittgt avatar Oct 19 '20 14:10 benoittgt

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

pirj avatar Sep 29 '23 14:09 pirj

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

JonRowe avatar Sep 30 '23 15:09 JonRowe