diff --git a/doc/api/assert.md b/doc/api/assert.md index 11def69df9a0..cf2212c90e13 100644 --- a/doc/api/assert.md +++ b/doc/api/assert.md @@ -510,13 +510,13 @@ assert.notDeepEqual(obj1, obj1); // AssertionError: { a: { b: 1 } } notDeepEqual { a: { b: 1 } } assert.notDeepEqual(obj1, obj2); -// OK, obj1 and obj2 are not deeply equal +// OK: obj1 and obj2 are not deeply equal assert.notDeepEqual(obj1, obj3); // AssertionError: { a: { b: 1 } } notDeepEqual { a: { b: 1 } } assert.notDeepEqual(obj1, obj4); -// OK, obj1 and obj4 are not deeply equal +// OK: obj1 and obj4 are not deeply equal ``` If the values are deeply equal, an `AssertionError` is thrown with a `message` diff --git a/doc/api/fs.md b/doc/api/fs.md index 0bbfd41d8081..8bc585d3a729 100644 --- a/doc/api/fs.md +++ b/doc/api/fs.md @@ -1672,7 +1672,7 @@ The file is created if it does not exist. * `'ax+'` - Like `'a+'` but fails if `path` exists. `mode` sets the file mode (permission and sticky bits), but only if the file was -created. It defaults to `0o666`, readable and writable. +created. It defaults to `0o666` (readable and writable). The callback gets two arguments `(err, fd)`. @@ -2568,7 +2568,7 @@ a new inode. The watch will emit an event for the delete but will continue watching the *original* inode. Events for the new inode will not be emitted. This is expected behavior. -In AIX, save and close of a file being watched causes two notifications - +On AIX, save and close of a file being watched causes two notifications - one for adding new content, and one for truncation. Moreover, save and close operations on some platforms cause inode changes that force watch operations to become invalid and ineffective. AIX retains inode for the diff --git a/doc/api/modules.md b/doc/api/modules.md index f9f311d241ce..8ca81cbda2f4 100644 --- a/doc/api/modules.md +++ b/doc/api/modules.md @@ -6,10 +6,8 @@ -Node.js has a simple module loading system. In Node.js, files and modules -are in one-to-one correspondence (each file is treated as a separate module). - -As an example, consider a file named `foo.js`: +In the Node.js module system, each file is treated as a separate module. For +example, consider a file named `foo.js`: ```js const circle = require('./circle.js');