style(schema): improve jsdocs examples

lib/schema.js

@@ -53,7 +53,7 @@ function createSchema(bucket) {
    * @description Write provided file into MongoDB GridFS
    * @param {stream.Readable} stream readable stream
    * @param {Function} [done] a callback to invoke in success or error
-   * @return {GridFSBucketWriteStream} a GridFSBucketWriteStream instance.
+   * @return {Model} valid instance of mongoose model.
    * @see {@link https://docs.mongodb.com/manual/core/gridfs/}
    * @see {@link http://mongodb.github.io/node-mongodb-native}
    * @see {@link https://nodejs.org/api/stream.html#stream_writable_streams}
@@ -63,11 +63,12 @@ function createSchema(bucket) {
    * @since 1.0.0
    * @version 0.1.0
    * @instance
-   * @instance
    * @example
    *
    * const attachment = new Attachment({ filename });
-   * attachment.write(readablestream, (error, attached) => { ... });
+   * attachment.write(readablestream, (error, attached) => {
+   *  //=> {_id: ..., filename: ..., ... }
+   * });
    *
    */
   FileSchema.methods.write = function write(stream, done) {
@@ -152,7 +153,9 @@ function createSchema(bucket) {
    * @instance
    * @example
    *
-   * attachment.unlink((error, unlinked) => { ... });
+   * attachment.unlink((error, unlinked) => {
+   *  //=> {_id: ..., filename: ..., ... }
+   * });
    *
    */
   FileSchema.methods.unlink = function unlink(done) {
@@ -198,7 +201,9 @@ function createSchema(bucket) {
    * const writeStream = Attachment.write({ filename }, readStream);
    *
    * // small file
-   * Attachment.write({ filename }, readstream, (error, file) => { ... });
+   * Attachment.write({ filename }, readstream, (error, file) => {
+   *  //=> {_id: ..., filename: ..., ... }
+   * });
    *
    */
   FileSchema.statics.write = function write(file, stream, done) {
@@ -271,7 +276,9 @@ function createSchema(bucket) {
    * @public
    * @example
    *
-   * Attachment.unlink(_id, (error, unlinked) => { ... });
+   * Attachment.unlink(_id, (error, unlinked) => {
+   *  //=> {_id: ..., filename: ..., ... }
+   * });
    *
    */
   FileSchema.statics.unlink = function unlink(_id, done) {