On Mon, Oct 31, 2022 at 03:25:12PM -0700, Benjamin Bini wrote: > Which project removes documentation as a way to encourage people to upgrade? > What is the next step? Removing the code from GitHub and removing artifacts > from online repositories? > > Node.js documentation goes back to 0.0.1 : https://nodejs.org/docs/ > Should you use Node 0.0.1? Of course not. But the doc is still online if > for some reason you need it. > And I took the first example that came to my mind. > > CAS documentation has always be really hard to navigate and understand, > especially for less experienced developpers. > How are you supposed to upgrade without the documentation from the version > you're coming from?
This is the piece that, I think, has been missing from the discussion until now: *why* one needs documentation for a prior version. So, you want to upgrade to the latest CAS release. This means that you need to understand the release that you are running now, so that you can set the new one up to meet the same needs. You have, after many months, gotten everyone to agree to downtime for a vital, cross-cutting service. Current production is several releases old. It may have been installed by someone else who has left the organization; it may have been installed by you, but that was a long time and many projects ago. The new release has *different* configuration properties, and may have been re-organized, so you can't just copy the setup and hope it works. Even a same-named property may have a subtly different meaning in the new version. So you start reading the old configuration. What does it all mean? The documentation for that version would help. The documentation for the new version may in some areas be useless or even misleading w.r.t. the old version. -- Mark H. Wood Lead Technology Analyst University Library Indiana University - Purdue University Indianapolis 755 W. Michigan Street Indianapolis, IN 46202 317-274-0749 www.ulib.iupui.edu -- - Website: https://apereo.github.io/cas - Gitter Chatroom: https://gitter.im/apereo/cas - List Guidelines: https://goo.gl/1VRrw7 - Contributions: https://goo.gl/mh7qDG --- You received this message because you are subscribed to the Google Groups "CAS Community" group. To unsubscribe from this group and stop receiving emails from it, send an email to cas-user+unsubscr...@apereo.org. To view this discussion on the web visit https://groups.google.com/a/apereo.org/d/msgid/cas-user/Y2EZ7UGwsf4lGUIe%40IUPUI.Edu.
signature.asc
Description: PGP signature
