💬 Replied to: hey don't on Twitter
““I’m writing a thing about bad documentation. Please give me specific examples of where documentation (open source or otherwise) has failed you, and how. Also what are the worst docs (for me to scream at)?
I’ll cite you, if you want me to. RTs also appreciated.””
The Shibboleth documentation is the most frustrating I’ve come across. As well as being dense and jargon-y, half of the links point to older versions, which tell you “THIS IS OUT OF DATE!!!” leaving you to wonder if you should keep reading… https://wiki.shibboleth.net/confluence/display/SP3/Home