update docs to reflect the changes to alist/plist behaviour