[doc] Document file system behavior