Skip to content

Inform user about deprecated doc #159

@benoittgt

Description

@benoittgt
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.

Activity

JonRowe

JonRowe commented on Oct 19, 2020

@JonRowe
Member

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.

transferred this issue fromrspec/rspec-devon Oct 19, 2020
benoittgt

benoittgt commented on Oct 19, 2020

@benoittgt
MemberAuthor

Yep good idea

pirj

pirj commented on Sep 29, 2023

@pirj
Member

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

JonRowe commented on Sep 30, 2023

@JonRowe
Member

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

      Development

      No branches or pull requests

        Participants

        @pirj@JonRowe@benoittgt

        Issue actions

          Inform user about deprecated doc · Issue #159 · rspec/rspec.github.io