docs: function readFiles(
    glob,
    { parsers = {}, encoding = 'utf-8', globOpts = {} } = {}
  ) {
    return getFiles(glob, globOpts).then(paths => {
      return Promise.all(
        paths.map(filepath => {
          return readFile(filepath, encoding).then(fileData => {
            const parser = matchParser(filepath, parsers);
            fileData = parser(fileData, filepath);
            if (typeof fileData === 'string') {
              fileData = { contents: fileData };
            }
            return Object.assign(fileData, { path: filepath });
          });
        })
      );
    });
  }