search

twbs / bootstrap

The most popular HTML, CSS, and JavaScript framework for developing responsive, mobile first projects on the web.
https://getbootstrap.com
MIT License
170.39k stars 78.81k forks source link

Docs: Dropdown from v4.0 does not link to 4.2.1 #28115

Closed alexlenail closed 3 years ago

alexlenail commented 5 years ago

The docs pages for bootstrap v4.0 contain a dropdown. That dropdown contains v4.1.3 listed as latest. It does not contain v4.2.1.

Example: https://getbootstrap.com/docs/4.0/components/list-group/

XhmikosR commented 5 years ago

Doesn't it make sense, though? They are old docs, hence the callout at the top.

artjomsimon commented 5 years ago

Hm, I think it's a usability bug. People landing at the old docs (via search engines, or by following old, but still valid links) don't necessarily know that the docs they're currently reading are, in fact, old.

If they doubt the freshness of the docs, they naturally will reach for the version dropdown, which worsens the situation by suggesting that 1) yes, they were right about suspecting the docs to be old, but 2) at the same time suggesting 4.1 were the newest version.

For example, looking at old PostgreSQL docs, even when browsing old docs, the (Current) label always points to the current release.

I think this is much clearer to understand, what do you think?

XhmikosR commented 5 years ago

The thing is that is a maintenance nightmare. We aren't rebuilding the old docs every time we have a new major/minor version.

So, I'm unsure how to proceed.

MartijnCuppens commented 5 years ago

Maybe we can load the versions list with ajax?

XhmikosR commented 5 years ago

You can try if you are up to it and ping me :)

XhmikosR commented 5 years ago

Something I just remembered: we do have the versions page built every time we release. So we could just remove all versions from the version switcher and link to that page or something.

alecpl commented 5 years ago

Maybe you could do something with "There's a newer version of Bootstrap 4!" element too. It appears if I access 4.2 docs e.g. https://getbootstrap.com/docs/4.2/components/forms/ which does not make sense.

leodluz commented 5 years ago

The thing is that is a maintenance nightmare. We aren't rebuilding the old docs every time we have a new major/minor version.

So, I'm unsure how to proceed.

Make a link named to "lastest' which automatically redirects to the latest available version. Try accessing https://getbootstrap.com/docs/ and you'll see that this is what happens. This way you will no longer have to change old docs.

joliss commented 4 years ago

This still seems to be happening. E.g. Google landed me on https://getbootstrap.com/docs/4.1/getting-started/introduction/ (version 4.1), but its dropdown doesn't list the 4.5 version of the same page.

techboyg5 commented 4 years ago

This still seems to be happening. E.g. Google landed me on https://getbootstrap.com/docs/4.1/getting-started/introduction/ (version 4.1), but its dropdown doesn't list the 4.5 version of the same page.

Grest!

XhmikosR commented 3 years ago

Closing for #28115