Improve notes about async versions of filesystemsyncaccesshandle methods

[chrisdavidmills]

Description

As detailed in #28647, the notes that mention this are wrong; the incorrect async versions of these methods are no longer supported in any modern browser. This PR fixes those notes as suggested.

Motivation

Additional details

Related issues and pull requests

Fixes #28647

[github-actions]

Preview URLs (9 pages)

• /en-US/docs/Web/API/FileSystemFileHandle
• /en-US/docs/Web/API/FileSystemSyncAccessHandle/close
• /en-US/docs/Web/API/FileSystemSyncAccessHandle/flush
• /en-US/docs/Web/API/FileSystemSyncAccessHandle/getSize
• /en-US/docs/Web/API/FileSystemSyncAccessHandle/read
• /en-US/docs/Web/API/FileSystemSyncAccessHandle/truncate
• /en-US/docs/Web/API/FileSystemSyncAccessHandle/write
• /en-US/docs/Web/API/FileSystemSyncAccessHandle
• /en-US/docs/Web/API/StorageManager/getDirectory

(comment last updated: 2023-09-05 13:11:25)

[wbamberg]

Thanks Chris! I had an annoying nitpicky comment, which is that these notes don't really belong in the Examples section - the best place for them IMO would be at the end of the preamble, just before ## Syntax.

But I won't insist on it.

What do you think?

[chrisdavidmills]

Thanks Chris! I had an annoying nitpicky comment, which is that these notes don't really belong in the Examples section - the best place for them IMO would be at the end of the preamble, just before ## Syntax.

But I won't insist on it.

What do you think?

Cheers @wbamberg; this is a reasonable comment. I have moved all of them as suggested where the note is directly relevant to the subject of the page, but I've left a couple as-is, in cases where the note really just relates to content of the example itself.