DOC: extended docstrings and added notes regarding invalid cases in quantization functions.