complement the abstract directive with better doc