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.
@xiang90: thanks for the comments - I have incorporated this and below mentioned edits.