docs: function map(object, iterator, follow = false) {
    // if the object is an object and is not empty
    if (is(object) && !empty(object) && typeof iterator === 'function') {
      // create an empty object for the result
      let result = {};
  
      // for each key/value in the object
      // follow is passed into each therefore the
      // each function works out whether to follow
      // the objects
      each(object, (key, value) => {
        // set the result to the object with the key/value computed
        // from the specified iterator
        result = set(result, key, iterator(key, value));
      }, follow);
  
      // return the result
      return result;
    }
  
    // if the object isn't an object or is empty return an
    // empty object because the iterator can't be ran to
    // compute the values
    return {};
  }