Update FileSystemObserver explainer

dslee414 commented 2 months ago

Updates FileSystemChangeType names from created/deleted/unsupported to appeared/disappeared/unknown:
- When a file or directory has been moved into (or out of) the watched scope, the file/dir is to be reported as "created" or "deleted" with respect to the scope; however, this naming may be confusing as it is not really newly created file/dir (or deleted). Therefore, new names "appeared" and "disappeared" are suggested instead.
- "unsupported" is renamed to "unknown" to indicate a general use case where a type is not known or not to be specified to the site for various reasons.
Change the data type of FileSystemChangeRecord.relativePathMovedFrom
- Providing a FileSystemHandle to a non-existing file would not make much sense, but it would be still useful for sites to know where a file/dir has been moved from. It should return an array of path components instead (similar to relativePathComponents).
Update stakeholder signal

a-sully commented 2 months ago

Please ensure to follow the guidelines at https://github.com/whatwg/meta/blob/main/COMMITTING.md when you submit this PR. Thanks!

annevk commented 2 months ago

It seems the guidelines were not followed. :-( This should have been a "Meta: " change as it doesn't change the standard. The commit body also repeats the commit title and the commit title contains a redundant reference to the PR...

dslee414 commented 2 months ago

Apologies! I misunderstood what "Meta: " prefix is for.

whatwg / fs

Update FileSystemObserver explainer #163