On Tue, 2022-11-01 at 09:06 -0400, Mark H. Wood wrote: > 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.
+1 -- - 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 [email protected]. To view this discussion on the web visit https://groups.google.com/a/apereo.org/d/msgid/cas-user/2f313de36b2ac134c380cd1c838814301d842d1b.camel%40ndsu.edu.
