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

Avoid implicit reference to a different training course without easy way to determine if this resource is outdated or the reference itself. #913

Open
acsr opened this issue Jan 16, 2025 · 2 comments
Assignees
Labels

Comments

@acsr
Copy link
Contributor

acsr commented Jan 16, 2025

https://training.plone.org/effective-volto/deployment/docker.html#docker
https://github.com/plone/training/blame/60163609df060055256d89f528fbc1d96434116d/docs/effective-volto/deployment/docker.md#L13

"It is recommended that you follow the best practices explained in the "Installing Plone" recent training course by Érico Andréi and Jens Klein."

It is almost impossible to check if this is still valid without properly referncing the state of the "Installing Plone" training. You have to jump back and forth and may still get no clue. A "Installing Plone" Training is not available as additional label for the issue.

Make this recommendation explicit and/or add a link you can use to figure this out at once.
Recent changes in Volto Setup suggestion (aka "new approach since cookieplone version x in 2024") could be added here to avoid barking up the wrong tree. Lets see what I may figure out later.

@acsr
Copy link
Contributor Author

acsr commented Jan 16, 2025

Googling for "installing plone training jens klein Érico Andréi" finds https://2022.training.plone.org/effective-volto/deployment/docker.html which contains only the remark, leading to the conclusion the origin of the remark is around 2022 and outdated!

I appreciate the efforts moving outdated trainings into archive container subdomains with the year of creation as prefix!

The mentioned "Installing Plone" training is found as announcement during conferences but not as text document reference:
https://2022.ploneconf.org/schedule/training/installing-plone
https://2023.ploneconf.org/training/installing-plone
https://2024.ploneconf.org/en/schedule/training/installing-and-deploying-plone

There is [Installing Plone for the Training] but that is not deployment!
https://2022.training.plone.org/plone_training_config/instructions_plone5.html
https://2023.training.plone.org/mastering-plone-5/instructions_plone5/index.html

Conclusion / Suggestion

  1. Write explicit references to the training ideally using canonical links leading to the latest version (which should work now with the oudated trainings using a year prefix in the url).
  2. Avoid explicit naming of trainers due to their name may change. (Sorry)

@stevepiercy
Copy link
Contributor

@sneridagh this is your issue to resolve. See also:

Because of the inaccurate information in the Effective Volto training, which has not been substantially updated since 2023, I am inclined to archive it as obsolete in February 2025.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

3 participants