Add doc strings for Lint_error's error type

*Variants labelled (experimental) are still undergoing testing; if they have failed it may be a bug in OCaml-CI.