cosmetics + improved doc