diff --git a/doc/api/assert.md b/doc/api/assert.md index 11def69df9a0cd..cf2212c90e13f3 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 0bbfd41d80818c..8bc585d3a7291a 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 f9f311d241ce92..8ca81cbda2f42f 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');