minor fix for #1786

doc update for directory deletion sequence to align with previous/create examples; also note the difference between empty and non-empty directory.
`/foo_dir' -> `/dir`.