FP-145: improved doc