The reason why cryptography is so bad.

Is this elitist culture in cryptography.

Alot of algorithms are described incomprehensively.

Let me give you an example.

You might get a well documented specification for implementation of ECDSA.

But it will lack something very 2 important concepts.

1. You should only use it with "safe curves"

2. It's does provide you with a list of "Safe curves"

Same goes for Shamir Secret Sharing. You can know how to implement the algorithm.

But there is so much extra "insider knowledge" or "tribal knowledge" that isn't obvious to non-cryptographers, that you need, for it to be secure.

Such knowledge is often (if not always) not documented. It's in obscure forums, papers and blog posts like this one.

There is no comprehensive encyclopedia for cryptography algorithms.

Developers write bad encryption code because cryptographers have bad documentation.

I would blame the cryptographers, not the developers.