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

PrimeVue 2 documentation removed? #7151

Open
Oliver-Saer opened this issue Jan 27, 2025 · 10 comments
Open

PrimeVue 2 documentation removed? #7151

Oliver-Saer opened this issue Jan 27, 2025 · 10 comments

Comments

@Oliver-Saer
Copy link

We're currently using PrimeVue 2, converting all of our components over to it from BootstrapVue ahead of our planned migration to Vue3 - since PrimeVue is compatible with Vue3 but BoostrapVue is not.

To access PrimeVue 2 specific documentation, we've been using this link: https://www.primefaces.org/primevue-v2. However, as of this morning, that link returns a 404 error.

Would it be possible for one of the following resolutions:

  • Provide an alternative link for PrimeVue 2 documentation.
  • If it has been removed, reinstate the PrimeVue 2 documentation.
  • If the above is not possible, provide the source code of the PrimeVue 2 documentation site so we can self-host.

Thank you in advance.

@pawmanaloto
Copy link
Contributor

Even on web archive we cannot access the documentation...

@Darshan562
Copy link

Yes, I also face the same issue.

@amaanhassim
Copy link

Yes, facing the same issue as well

@MelkorCC
Copy link

If the above is not possible, provide the source code of the PrimeVue 2 documentation site so we can self-host.

@Oliver-Saer The documentation is still in the repo, there is a 2.x branch and a tag for 2.10.4. You should be able to use these to selfhost the documentation locally.

I think the problem here is that Vue 2 had it's EOL in 2023 and while i don't know when PrimeVue 2 had it's EOL, V3 had it's EOL at the end of 2024.
So PrimeVue 2 is kind of "two times EOL" at this point and i am not surprised the documentation was taken down. I mean the last commit to PrimeVue 2 happened 2 years ago and the branch is 8000 commits behind the master ...

@pedrociarlini
Copy link

pedrociarlini commented Jan 28, 2025

@Oliver-Saer The documentation is still in the repo, there is a 2.x branch and a tag for 2.10.4. You should be able to use these to selfhost the documentation locally.

Yeah... thats the way.

To help others to self host:

# git clone https://github.com/primefaces/primevue.git
# cd primevue
# git switch 2.x
# npm install
# npm run serve

@Rcjuk
Copy link

Rcjuk commented Jan 29, 2025

If the above is not possible, provide the source code of the PrimeVue 2 documentation site so we can self-host.

@Oliver-Saer The documentation is still in the repo, there is a 2.x branch and a tag for 2.10.4. You should be able to use these to selfhost the documentation locally.

I think the problem here is that Vue 2 had it's EOL in 2023 and while i don't know when PrimeVue 2 had it's EOL, V3 had it's EOL at the end of 2024. So PrimeVue 2 is kind of "two times EOL" at this point and i am not surprised the documentation was taken down. I mean the last commit to PrimeVue 2 happened 2 years ago and the branch is 8000 commits behind the master ...

You have to remember in companies, it can take time to build a plan to swap out older tech for the newer version. Often it's heavily embedded and can't just be ripped out and swapped quickly and easily. Two years is not a long time in that respect.

Maybe Primefaces can consider this and bring it back for now until people can make a plan. As far as I'm aware, there was no notice of this removal.

@MelkorCC
Copy link

MelkorCC commented Jan 29, 2025

You have to remember in companies, it can take time to build a plan to swap out older tech for the newer version. Often it's heavily embedded and can't just be ripped out and swapped quickly and easily. Two years is not a long time in that respect.

I totally agree that migrations take time, but to be fair the Vue 2 EOL was not announced in 2023, but at the beginning of 2022 when Vue 3 became the default version. So it is not like people were surprised in 2023 when Vue 2 had it's EOL. Given that we are now at the beginning of 2025 people actually had 3 years to migrate from Vue 2 to Vue 3.

Maybe Primefaces can consider this and bring it back for now until people can make a plan.

Like we already established, the documentation is still there. It is not gone, you can still clone it and run it locally.

As far as I'm aware, there was no notice of this removal.

I agree that the communication could have been better, but then again PrimeVue 2 is one way or another far past it's end of life so i would argue that them dropping the documentation without a notice is also not completely unexpected. Of course it would have been cool to have the documentation online indefinitely, but i guess it was just a cost factor in the end. But that is just a guess, i am not working at PrimeTek so i don't know the reasons for sure. Their other frameworks (primereact, primeng) also limit the online available documentation to the version that haven't reached their EOL yet. So it is not like PrimeVue is the exception with regards to this at PrimeTek. For example primeng has as of writing this the documentation for v17, 18 and 19 online, older versions that are already at their EOL are not online anymore. I guess people using older versions also just run the documentation locally.

Edit: @Rcjuk putting negative emojis under every one of my messages (even the one that did answer the question the author had with regards to the availability of the documentation in the repo) is a bit childish, don't you think?

@pawmanaloto
Copy link
Contributor

You have to remember in companies, it can take time to build a plan to swap out older tech for the newer version. Often it's heavily embedded and can't just be ripped out and swapped quickly and easily. Two years is not a long time in that respect.

I totally agree that migrations take time, but to be fair the Vue 2 EOL was not announced in 2023, but at the beginning of 2022 when Vue 3 became the default version. So it is not like people were surprised in 2023 when Vue 2 had it's EOL. Given that we are now at the beginning of 2025 people actually had 3 years to migrate from Vue 2 to Vue 3.

Maybe Primefaces can consider this and bring it back for now until people can make a plan.

Like we already established, the documentation is still there. It is not gone, you can still clone it and run it locally.

As far as I'm aware, there was no notice of this removal.

I agree that the communication could have been better, but then again PrimeVue 2 is one way or another far past it's end of life so i would argue that them dropping the documentation without a notice is also not completely unexpected. Of course it would have been cool to have the documentation online indefinitely, but i guess it was just a cost factor in the end. But that is just a guess, i am not working at PrimeTek so i don't know the reasons for sure. Their other frameworks (primereact, primeng) also limit the online available documentation to the version that haven't reached their EOL yet. So it is not like PrimeVue is the exception with regards to this at PrimeTek. For example primeng has as of writing this the documentation for v17, 18 and 19 online, older versions that are already at their EOL are not online anymore. I guess people using older versions also just run the documentation locally.

Edit: @Rcjuk putting negative emojis under every one of my messages (even the one that did answer the question the author had with regards to the availability of the documentation in the repo) is a bit childish, don't you think?

Migrating isn’t always a quick process, especially for teams managing large codebases or limited resources. Many web apps and websites still need to be maintained while the migration is underway. We understand that the version is EOL and no longer supported, but the reality is that it still works. For some companies, as long as their system functions as expected, the version they’re on isn’t a priority.

@MelkorCC
Copy link

MelkorCC commented Jan 29, 2025

Migrating isn’t always a quick process, especially for teams managing large codebases or limited resources. Many web apps and websites still need to be maintained while the migration is underway.

@pawmanaloto i completely understand this, resources are always limited and companies will always try to spend as little time (and money) on projects as possible. But i don't know what to tell you besides that PrimeTek seems to always handle their documentation like this. We just didn't notice this as much with PrimeVue as with their other frameworks (PrimeNG, PrimeReact) since we got less major releases (and thus less EOL versions).

Based on the downvotes i got from you and others here i get the feeling people here act as if i personally made that decision, which isn't the case. Don't shoot the messenger ...

@Desarrollos-Web-Urquiza

The documentation yet is visible if use the Web Archive: https://web.archive.org/web/20220323102337/https://www.primefaces.org/primevue-v2/#/

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

8 participants