Older documentation is no longer available

[Benjamin Bini]

Hello,

Why did the older CAS 5.x and early 6.x disappeared ? It is really sad that such an important resource for running projects is not available any more, except if you go to GitHub to read the md files...

Thanks,

[Benjamin Bini]

Up. Any info on this topic?

Thanks!

[Jim Toth]

I'd like to add my vote here for documentation for older versions to be available.

It would be fine, even a good idea, to put some kind of banner saying "This version is no longer maintained, please update it," ideally on all pages, but not having the documentation easily available makes the software harder to maintain, which in turn makes it harder to update.

--
- 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+u...@apereo.org.
To view this discussion on the web visit https://groups.google.com/a/apereo.org/d/msgid/cas-user/1e5c5f00-d326-4052-abaa-3f6e97a443a9n%40apereo.org.

[Andrea Colajacomo]

I totally agree.

Bye

[Ray Bon]

Please consider that Cas is a critical part of your security infrastructure. As such, it should be updated regularly to stay within supported versions.

If a vulnerability is discovered (i.e., log4j2), only supported versions will be patched.

Deploying a patch is much simpler than upgrading, hours vs days/weeks.

It is our job to push back on management to get demand time to perform upgrades.

<steps off soap box>

Ray

On Wed, 2022-10-19 at 06:43 -0700, Benjamin Bini wrote:

Notice: This message was sent from outside the University of Victoria email system. Please be cautious with links and sensitive information.

[King, Robert]

Seconded

--

- 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+u...@apereo.org.

To view this discussion on the web visit https://groups.google.com/a/apereo.org/d/msgid/cas-user/3dfdf25b9370a9bdbee3a334edf8573c4cca140a.camel%40uvic.ca.

[Benjamin Bini]

Of course it is more than a priority to upgrade, but removing the documentation is not a good solution to force people to do it.

It just makes people want to use another tech stack which keep documentation online. You just making developer's lifes harder by removing it, not management.

Put big red blinking warnings, but do not remove entirely the documentation.

[Benjamin Bini]

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?

Sorry if I sound a bit angry but this kind of stuff makes life harder for so many people and encourage customers to use proprietary solutions, which is sad.

[Jason Everling]

although its a bit sluggish, web archive has it, it's also on github source code under docs if you want to build it, this has 4.x up to 6.3 using the date I randomly chose,

https://web.archive.org/web/20210616111636/https://apereo.github.io/cas/5.0.x/

---

From: cas-...@apereo.org <cas-...@apereo.org> on behalf of Benjamin Bini <benj...@bini.io>
Sent: Monday, October 31, 2022 5:25:12 PM
To: CAS Community <cas-...@apereo.org>
Cc: Benjamin Bini <benj...@bini.io>; Ray Bon <rb...@uvic.ca>
Subject: Re: [cas-user] Re: Older documentation is no longer available

 

--
- 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+u...@apereo.org.

To view this discussion on the web visit https://groups.google.com/a/apereo.org/d/msgid/cas-user/b46aa872-3778-452b-9c46-186c0666aaf7n%40apereo.org.

[Mark H. Wood]

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

[Richard Frovarp]

+1

[Trevor Fong]

Having recently done exactly this, +100

--
- 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+u...@apereo.org.

To view this discussion on the web visit https://groups.google.com/a/apereo.org/d/msgid/cas-user/2f313de36b2ac134c380cd1c838814301d842d1b.camel%40ndsu.edu.

[Sanjay Semwal]

Thanks for sharing this archive link.

To view this discussion on the web visit https://groups.google.com/a/apereo.org/d/msgid/cas-user/BL0PR05MB52688BE35DA05FE88081108EFF369%40BL0PR05MB5268.namprd05.prod.outlook.com.

[Benjamin Bini]

Thank you for the archive link indeed.

I have no idea how CAS governance works, but is there any change for the older doc to get back online? Who should we ping to push this request?

Thank you!

[Mickaël]

Hi,

Documentation is available in the repo in doc folder.

For version 5.3.x https://github.com/apereo/cas/tree/5.3.x/docs

Cheers,

Mickaël

To view this discussion on the web visit https://groups.google.com/a/apereo.org/d/msgid/cas-user/c0c66a0a-7833-4ac1-a124-79cb9a7ca6acn%40apereo.org.

[Benjamin Bini]

Hello,

Thank you for your reply, it is available as md files indeed, but it is not easily browsable or searchable.

Why not put it back on the website?

It would help a lot of people and hurt no one, I really don't get it.

Thank you,

Benjamin