docs: function (fileCurrentReference, file) {
  
          var representations = [];
  
          //  Scenario 2: Current file is the same directory or lower than the reference
          //              (ie. file.path and the reference file.path are the same)
          //
          //                  file.base = /user/project
          //                  file.path = /user/project/second/current_file.html
          //  fileCurrentReference.path = /user/project/second/index.html
  
          if (dirname_with_sep(fileCurrentReference.path).indexOf(dirname_with_sep(file.path)) === 0) {
  
              //  index.html
              representations.push(get_relative_path(Path.dirname(file.path), fileCurrentReference.revPathOriginal, true));
  
              //  ./index.html   (reference: relative)
              representations.push('.' + get_relative_path(Path.dirname(file.path), fileCurrentReference.revPathOriginal, false));
          }
  
          //  Scenario 3: Current file is in a different child directory than the reference
          //            (ie. file.path and the reference file.path are different, not in root directory)
          //
          //                  file.base = /user/project
          //                  file.path = /user/project/first/index.html
          //  fileCurrentReference.path = /user/project/second/index.html
  
          if (dirname_with_sep(file.path) !== dirname_with_sep(fileCurrentReference.path) &&
              dirname_with_sep(fileCurrentReference.path).indexOf(dirname_with_sep(file.path)) === -1) {
  
              var pathCurrentReference = dirname_with_sep(get_relative_path(fileCurrentReference.base, fileCurrentReference.revPathOriginal));
              var pathFile = dirname_with_sep(get_relative_path(file.base, file.revPathOriginal));
  
              // ../second/index.html
              var relPath = Path.relative(pathFile, pathCurrentReference);
              relPath = relPath.replace(/\\/g, '/');
              representations.push(relPath + '/' + Path.basename(fileCurrentReference.revPathOriginal));
          }
  
          return representations;
  
      }