There are a lot of areas that it needs some serious improvement. I'm slowly
writing a document on organizational issues related to the documentation, so
that I can share it with everyone. The biggest issue is that it makes you jump
around a lot. For example, having one MASSIVE properties document isn't
helpful. The properties related to a specific module that you must enable
should be in the document for that module.
For example, the following document has documentation on enabling LDAP
authentication, yet no information on how to configure it, it forces you to
click out to the properties document for that.
https://apereo.github.io/cas/5.2.x/installation/LDAP-Authentication.html
Furthermore, ldap password management is a separate topic from authentication,
and should be in it's own document entirely.
At some point, I could probably take some time to adjust some docs, but I'd
need to be assured they will be the way that the devs find acceptable, or I'd
just be wasting my time. :D Plus, I'm not sure how everything would conflict
with the master branch.
Anyhow, I found the docs to be "mostly" complete, just very disconnected. If
all individual components had their own documentation page, with everything needed to get
that one single piece working, life would be beautiful. :D Not only would that be nice,
but it would also end up being a printable document.
On 2018-07-20 06:44 PM, Elendrys Yagami wrote:
I was totally thinking about posting a complain about the doc. I spent hours a
year ago to understand how to setup the soft. I am deploying the latest version
now and while I forgot a lot about what I did and what I got, I also see that
it grew.
We can easily get "you want to do that, compile the module and add the
settings". And I'd like to congratulate CAS developers to move from XML Land to a
readable property file. But it's also true that the thousands lines long config page
mixes everything in a messy way. You may not see the sentence with a link to extended
explanations and get lost.
You may use resources to make the project more attractive by giving a good doc. The payed
solution should be an engeneering assistance, not a "hey we develop it for free but
the doc is so odd that you may not successfully deploy it on your own". Look at
Docker, opensource, easy, clear, and then they add paid improvments for enterprise class
services. They a
--
- 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]<mailto:[email protected]>.
To view this discussion on the web visit
https://groups.google.com/a/apereo.org/d/msgid/cas-user/10a8adf7-8beb-429a-8785-19b5791f2864%40apereo.org<https://groups.google.com/a/apereo.org/d/msgid/cas-user/10a8adf7-8beb-429a-8785-19b5791f2864%40apereo.org?utm_medium=email&utm_source=footer>.
--
Trenton D. Adams
Senior Systems Analyst/Web Software Developer
Applications Unit - ITS
Athabasca University
(780) 675-6195
It is only when you are surrounded by a supportive team, that you can achieve
your best. Instead of tearing people down, try building them up!
--
This communication is intended for the use of the recipient to whom it is
addressed, and may contain confidential, personal, and or privileged
information. Please contact us immediately if you are not the intended
recipient of this communication, and do not copy, distribute, or take action
relying on it. Any communications received in error, or subsequent reply,
should be deleted or destroyed.
---
--
- 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/d27bd236-16ed-6aa5-0ad3-fbdcd791a3f2%40athabascau.ca.
