Markdown linter integration

[superkhau]

Come up with a proposal to answer the following:

• What linter to use
  • Must support Kramdown
  • remark-lint suggested by @bajtos is a good place to start
• General Usage
  • Ad hoc (ie. npm run lint)
  • CI (ie. posttest: npm run lint)
• List of things to do during the actual tasks (ie. update readme with ad hoc usage instructions for loopback.io repo, submit PR with dep/integration with remark-lint, etc)

[Sequoia]

@crandmck pointed me to me this ticket as something I might be able to help with. What's the specific goal/deliverable here?

Is it: Create a script that reads & validates (lints) the top level README.md files across all strongloop repos?

[crandmck]

@superkhau ^

[superkhau]

@Sequoia Start with loopback.io files. We can decide after that trial run to see if we want to integrate the script into each LB repo afterwards based on your discoveries (and standards you decide upon in the configuration of remark-lint -- we can discuss more during the review of your PR to loopback.io -- cc me in that PR).

[superkhau]

@Sequoia Please reference your PR to this issue too.

[crandmck]

To clarify: the point of this exercise was to detect and resolve layout errors in loopback.io due to poorly-formatted markdown. Very little of that exists in the "regular" markdown files in pages directory of loopback.io.

Far more useful would be to correct problems in the READMEs being pulled into the docs from other repos (repos.json lists them). For example: http://loopback.io/doc/en/lb2/Tutorial-android-getting-started.html (list at end of document does not layout correctly) and http://loopback.io/doc/en/lb2/Tutorial-access-control.html (headings not formatted correctly).

[Sequoia]

mdl uses Kramdown (and looks like it could do the job). Noting that here in case there are issues with remark-lint (which uses remark). Moving forward with remark-lint because while this repo does already depend on ruby, this particular task (extra-repo READMEs) already uses JS (get-readmes).

[Sequoia]

Starting point: linting _includes/readmes:

remark ./_includes/readmes 745 warnings

_includes/readmes/loopback-example-kv-connectors.md
      1:27-1:72  warning  Don’t use literal URLs without angle brackets         no-literal-urls              remark-lint
            9:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           10:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint

_includes/readmes/loopback-android-getting-started.md
            9:4  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           10:4  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
     12:1-12:55  warning  Marker style should be `.`                            ordered-list-marker-style    remark-lint
           12:3  warning  Incorrect indentation before bullet: remove 3 spaces  list-item-bullet-indent      remark-lint
           12:6  warning  Incorrect list-item indent: remove 1 space            list-item-indent             remark-lint
     13:1-13:52  warning  Marker style should be `.`                            ordered-list-marker-style    remark-lint
           13:3  warning  Incorrect indentation before bullet: remove 3 spaces  list-item-bullet-indent      remark-lint
           13:6  warning  Incorrect list-item indent: remove 1 space            list-item-indent             remark-lint
     14:1-14:44  warning  Marker style should be `.`                            ordered-list-marker-style    remark-lint
           14:3  warning  Incorrect indentation before bullet: remove 3 spaces  list-item-bullet-indent      remark-lint
           14:6  warning  Incorrect list-item indent: remove 1 space            list-item-indent             remark-lint
     15:1-15:38  warning  Marker style should be `.`                            ordered-list-marker-style    remark-lint
           15:3  warning  Incorrect indentation before bullet: remove 3 spaces  list-item-bullet-indent      remark-lint
           15:6  warning  Incorrect list-item indent: remove 1 space            list-item-indent             remark-lint
           16:4  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
     17:1-17:26  warning  Marker style should be `.`                            ordered-list-marker-style    remark-lint
           17:3  warning  Incorrect indentation before bullet: remove 3 spaces  list-item-bullet-indent      remark-lint
           17:6  warning  Incorrect list-item indent: remove 1 space            list-item-indent             remark-lint
     18:1-18:62  warning  Marker style should be `.`                            ordered-list-marker-style    remark-lint
           18:3  warning  Incorrect indentation before bullet: remove 3 spaces  list-item-bullet-indent      remark-lint
           18:6  warning  Incorrect list-item indent: remove 1 space            list-item-indent             remark-lint
     19:1-19:74  warning  Marker style should be `.`                            ordered-list-marker-style    remark-lint
           19:3  warning  Incorrect indentation before bullet: remove 3 spaces  list-item-bullet-indent      remark-lint
           19:6  warning  Incorrect list-item indent: remove 1 space            list-item-indent             remark-lint
     20:1-20:39  warning  Marker style should be `.`                            ordered-list-marker-style    remark-lint
           20:3  warning  Incorrect indentation before bullet: remove 3 spaces  list-item-bullet-indent      remark-lint
           20:6  warning  Incorrect list-item indent: remove 1 space            list-item-indent             remark-lint
           21:4  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           24:5  warning  Incorrect indentation before bullet: remove 2 spaces  list-item-bullet-indent      remark-lint
           25:5  warning  Incorrect indentation before bullet: remove 2 spaces  list-item-bullet-indent      remark-lint
           26:5  warning  Incorrect indentation before bullet: remove 2 spaces  list-item-bullet-indent      remark-lint
           30:5  warning  Incorrect indentation before bullet: remove 2 spaces  list-item-bullet-indent      remark-lint
           31:5  warning  Incorrect indentation before bullet: remove 2 spaces  list-item-bullet-indent      remark-lint
           32:5  warning  Incorrect indentation before bullet: remove 2 spaces  list-item-bullet-indent      remark-lint
           36:4  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           37:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           38:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           39:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           40:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           41:4  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint

_includes/readmes/loopback-example-middleware.md
            9:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint

_includes/readmes/loopback-example-angular-live-set.md
           66:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           66:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           67:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           67:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           68:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           68:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           72:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           72:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           73:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           73:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           74:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           74:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint

_includes/readmes/loopback-example-access-control.md
           14:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           14:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           15:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           15:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           16:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           16:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           17:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           17:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           26:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           27:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           28:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           29:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           33:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           34:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           35:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           36:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           37:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           45:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           46:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           57:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           58:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           59:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           60:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           61:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           62:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           63:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           64:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           65:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           66:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           67:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           68:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           69:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           70:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           71:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           72:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           73:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           74:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           75:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           76:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           77:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           78:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           79:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           80:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           81:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           82:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           83:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           84:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           85:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           86:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           87:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          101:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          102:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          103:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          109:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          110:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          111:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          112:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          113:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          114:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          115:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          116:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          117:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          118:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          119:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          120:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          121:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          122:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          123:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          124:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          125:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          126:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          127:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          128:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          129:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          137:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          139:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          141:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          143:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          167:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          168:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          169:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          170:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          195:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          196:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          197:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          198:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          199:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          200:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          201:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          202:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          203:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          204:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          205:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          206:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          207:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          208:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          209:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          210:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          211:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          212:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          213:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          214:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          215:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          216:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          217:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          218:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          219:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          220:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          221:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          222:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          223:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          224:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          225:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          226:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          227:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          228:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          229:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          230:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          231:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          232:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
  241:38-241:67  warning  Found reference to undefined definition               no-undefined-references      remark-lint
          243:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          244:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          245:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          246:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          247:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          248:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          249:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          250:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          251:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          252:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          253:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          254:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint

_includes/readmes/loopback-example-mixins.md: no issues found
_includes/readmes/loopback-example-connector-remote.md
            9:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           10:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           11:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           13:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           14:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           14:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
    20:101-21:1  warning  Use two spaces for hard line breaks                   hard-break-spaces            remark-lint
    41:31-41:60  warning  Don’t use literal URLs without angle brackets         no-literal-urls              remark-lint
     43:7-43:50  warning  Don’t use literal URLs without angle brackets         no-literal-urls              remark-lint
           61:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           61:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           62:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           62:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           63:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           63:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           64:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           64:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint

_includes/readmes/loopback-example-angular.md
           17:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           18:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           22:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           23:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           24:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           25:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           26:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           27:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           28:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           29:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           30:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           38:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           39:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           51:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           52:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           53:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           54:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           55:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           56:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           57:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           58:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           59:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           71:1  warning  Missing caret in blockquote                           no-blockquote-without-caret  remark-lint
           72:1  warning  Missing caret in blockquote                           no-blockquote-without-caret  remark-lint
          114:1  warning  Missing caret in blockquote                           no-blockquote-without-caret  remark-lint

_includes/readmes/loopback-example-app-logic.md
           18:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           19:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           20:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           24:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           25:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           33:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           34:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           46:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           47:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           48:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           49:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           50:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           51:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           52:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           53:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           54:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           55:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           56:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           57:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           86:1  warning  Missing caret in blockquote                           no-blockquote-without-caret  remark-lint
          226:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
          227:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
          228:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
          232:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          233:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          234:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint

_includes/readmes/loopback-example-passport.md
            5:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
            6:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
            7:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
            8:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           15:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           16:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           22:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           23:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           24:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           28:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           29:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           30:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           45:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           46:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           47:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
    47:21-47:61  warning  Found reference to undefined definition               no-undefined-references      remark-lint
    47:21-47:61  warning  Use the trailing [] on reference links                no-shortcut-reference-link   remark-lint
           48:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           49:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           50:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           51:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           52:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           56:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           57:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          105:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          117:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          125:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          126:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          127:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint

_includes/readmes/loopback-example-database-mysql.md
            5:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
            6:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
            7:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
            8:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           14:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           15:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           16:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           17:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           18:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           19:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           20:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           47:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           48:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           49:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           66:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           67:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           85:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           86:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          122:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          123:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          124:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          125:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          126:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          127:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          128:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          129:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          130:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          131:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          132:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          133:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          134:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          135:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          136:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          193:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          194:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint

_includes/readmes/loopback-example-connector-rest.md
       1:1-1:45  warning  Found unused definition                               no-unused-definitions        remark-lint
            5:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
            6:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
            7:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint

_includes/readmes/loopback-example-connector-soap.md: no issues found
_includes/readmes/loopback-example-database-mssql.md
            5:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
            6:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
            7:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
            8:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           14:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           15:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           16:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           17:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           18:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           19:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           20:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           47:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           48:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           49:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           66:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           67:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           85:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           86:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          122:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          123:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          124:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          125:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          126:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          127:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          128:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          129:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          130:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          131:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          132:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          133:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          134:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          135:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          136:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          193:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          194:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint

_includes/readmes/loopback-example-remote.md: no issues found
_includes/readmes/loopback-example-isomorphic.md: no issues found
_includes/readmes/loopback-example-database-postgresql.md
            5:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
            6:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
            7:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
            8:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           14:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           15:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           16:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           17:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           18:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           19:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           20:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           47:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           48:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           49:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           66:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           67:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           85:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           86:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          123:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          124:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          125:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          126:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          127:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          128:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          129:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          130:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          131:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          132:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          133:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          134:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          135:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          136:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          137:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          194:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          195:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint

_includes/readmes/loopback-example-database.md
            5:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
            6:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
            7:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
            8:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           14:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           15:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           16:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           17:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           18:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           19:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           20:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           47:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           48:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           49:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           66:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           67:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           85:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           86:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          123:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          124:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          125:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          126:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          127:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          128:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          129:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          130:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          131:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          132:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          133:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          134:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          135:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          136:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          137:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          197:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          198:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint

_includes/readmes/loopback-example-database-oracle.md
            5:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
            6:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
            7:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
            8:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           14:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           15:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           16:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           17:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           18:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           19:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           20:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           47:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           48:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           49:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           66:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           67:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          114:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          115:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          152:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          153:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          154:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          155:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          156:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          157:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          158:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          159:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          160:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          161:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          162:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          163:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          164:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          165:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          166:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          223:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          224:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint

_includes/readmes/loopback-example-offline-sync.md
            8:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
            8:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
            9:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
            9:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           13:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           16:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           18:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           20:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           22:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           24:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           26:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           28:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           31:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           33:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           39:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           39:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           42:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           42:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           46:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           46:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           50:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           50:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           62:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           62:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           64:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           64:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           68:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           68:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           75:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           75:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           77:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           77:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           79:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           79:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           80:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           80:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           82:3  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           82:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           90:4  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           95:4  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           98:4  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
          109:4  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
          119:4  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
          133:4  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
          145:4  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
          151:4  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
          157:4  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint

_includes/readmes/loopback-example-pubsub.md
            6:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
            7:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint

_includes/readmes/loopback-example-relations.md
           18:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           19:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           23:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           24:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           25:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           26:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           34:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           35:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           45:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           46:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           47:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           58:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           59:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           60:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           61:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           62:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           63:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           64:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           65:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           66:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           67:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           68:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           69:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           70:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           71:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           72:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           73:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           74:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           75:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           76:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           77:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           78:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           79:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           80:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           81:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           82:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           83:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           84:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           85:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           86:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           87:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           88:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           89:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           90:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           91:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           92:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           93:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           94:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           95:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           96:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           97:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           98:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           99:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          100:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          101:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          102:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          103:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          104:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          105:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          106:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          107:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          108:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          109:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          110:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          111:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          112:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          113:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          114:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          115:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          116:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          117:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          118:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          119:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          120:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          121:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          122:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          123:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          124:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          125:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          126:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          127:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          128:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          129:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          130:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          131:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          132:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          133:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          134:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          135:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          136:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          137:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          138:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          139:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          140:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          141:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          142:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          143:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          144:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          145:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          146:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          147:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          148:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          149:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          150:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          152:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          153:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          154:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          155:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          156:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          157:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          158:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          159:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          160:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          161:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          162:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          163:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          164:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          165:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          166:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          202:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          203:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          204:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          205:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          206:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          214:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          215:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          216:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          217:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          218:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          219:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          220:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          252:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          263:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          278:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          279:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          280:7  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          281:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          282:9  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
  298:51-298:80  warning  Found reference to undefined definition               no-undefined-references      remark-lint
          302:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          303:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          304:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          305:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          306:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          307:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          308:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          309:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          310:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          311:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          312:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          313:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          314:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          315:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          316:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          317:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          318:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          319:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          322:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          323:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          326:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          327:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          330:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          331:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          332:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          333:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          334:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          335:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          338:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          339:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          340:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          341:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          342:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
          343:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint

_includes/readmes/loopback-example-storage.md
    15:11-15:32  warning  Don’t use literal URLs without angle brackets         no-literal-urls              remark-lint

_includes/readmes/loopback-example-user-management.md
            9:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           10:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           11:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           12:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           13:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           14:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           17:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           18:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           19:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           22:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           23:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           24:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           25:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           26:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           27:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           37:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           38:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           39:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           40:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           41:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           42:5  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           56:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           65:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint

_includes/readmes/loopback-example-xamarin.md
            5:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
            6:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           10:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           11:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           12:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           20:5  warning  Remove 1 space before this heading’s content          no-heading-content-indent    remark-lint
   22:92-22:125  warning  Don’t use literal URLs without angle brackets         no-literal-urls              remark-lint
           26:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           28:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
    35:59-35:92  warning  Don’t use literal URLs without angle brackets         no-literal-urls              remark-lint
           53:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           54:6  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           55:6  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           56:6  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           57:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           59:4  warning  Incorrect list-item indent: add 1 space               list-item-indent             remark-lint
           61:3  warning  Incorrect indentation before bullet: remove 3 spaces  list-item-bullet-indent      remark-lint
           61:6  warning  Incorrect list-item indent: remove 1 space            list-item-indent             remark-lint
           62:3  warning  Incorrect indentation before bullet: remove 3 spaces  list-item-bullet-indent      remark-lint
           62:6  warning  Incorrect list-item indent: remove 1 space            list-item-indent             remark-lint
    62:12-62:29  warning  Don’t pad `strong` with inner spaces                  no-inline-padding            remark-lint
           63:3  warning  Incorrect indentation before bullet: remove 3 spaces  list-item-bullet-indent      remark-lint
           63:6  warning  Incorrect list-item indent: remove 1 space            list-item-indent             remark-lint
           64:3  warning  Incorrect indentation before bullet: remove 3 spaces  list-item-bullet-indent      remark-lint
           64:6  warning  Incorrect list-item indent: remove 1 space            list-item-indent             remark-lint
           65:3  warning  Incorrect indentation before bullet: remove 3 spaces  list-item-bullet-indent      remark-lint
           65:6  warning  Incorrect list-item indent: remove 1 space            list-item-indent             remark-lint
           74:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           75:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint
           76:3  warning  Incorrect list-item indent: add 2 spaces              list-item-indent             remark-lint

_includes/readmes/loopback-getting-started-intermediate.md: no issues found
_includes/readmes/loopback-getting-started.md: no issues found
_includes/readmes/loopback-ios-getting-started.md
           10:4  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           11:4  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
           12:4  warning  Incorrect indentation before bullet: remove 1 space   list-item-bullet-indent      remark-lint
     25:1-25:53  warning  Found unused definition                               no-unused-definitions        remark-lint

⚠ 745 warnings

These are primarily list-item-indent type warnings, which don't actually break the markdown parser.

[Sequoia]

Still working on this... remark-lint ended up being very challenging to configure, it's configured in a style much like babel6: configs, presets, plugins, plugin-configs etc..

I had to do a bit of a deep-dive to figure out why remark-lint was not catching any of the faulty headings (I wasn't sure if I was configuring it wrong or what). Turns out the issue is a bit trickier: because remark parses the .md file to an AST and then passes it to plugins, if it doesn't recognize #welcome as a header, it doesn't get passed to header-checking rules. Basically the issue is sort of circular: it can't validate the markdown syntax because it has syntax problems.

#loopback-example-access-control

Get first child of AST: it's a "paragraph"

./node_modules/.bin/remark --tree-out -S _includes/readmes/loopback-example-access-control.md | json children[0]

{
  "type": "paragraph",
  "children": [
    {
      "type": "text",
      "value": "#loopback-example-access-control",
      "position": {
        "start": {
          "line": 1,
          "column": 1,
          "offset": 0
        },
        "end": {
          "line": 1,
          "column": 33,
          "offset": 32
        },
        "indent": []
      }
    }
  ],
  "position": {
    "start": {
      "line": 1,
      "column": 1,
      "offset": 0
    },
    "end": {
      "line": 1,
      "column": 33,
      "offset": 32
    },
    "indent": []
  }
}

# loopback-example-access-control

Get first child of AST: it's a "heading"

./node_modules/.bin/remark --tree-out -S _includes/readmes/loopback-example-access-control.md | json children[0]

{
  "type": "heading",
  "depth": 1,
  "children": [
    {
      "type": "text",
      "value": "loopback-example-access-control",
      "position": {
        "start": {
          "line": 1,
          "column": 3,
          "offset": 2
        },
        "end": {
          "line": 1,
          "column": 34,
          "offset": 33
        },
        "indent": []
      }
    }
  ],
  "position": {
    "start": {
      "line": 1,
      "column": 1,
      "offset": 0
    },
    "end": {
      "line": 1,
      "column": 34,
      "offset": 33
    },
    "indent": []
  }
}

👉 Remark-lint cannot, natively, detect this issue. I'll look into plugins that do, if I can't find one I'll discard it and switch tools.

[crandmck]

OK, great...please do see if you can find a tool that detects the header issue (missing space after #), because I think we have a lot of those.

[superkhau]

Should also try to see if the tool you're trying out supports a --fix option like ESLint to auto fix errors based on explicit rules from a config file.

[Sequoia]

Fenced code blocks in nested lists

This one is very tricky...

7 Space indent

OL > UL

1. Top level
  * Second level

       ```
       <android-sdk>/extras/google/google_play_services/libproject/google-play-services_lib/
       ```
  * Another on second level

• ✅ Works with kramdown
• also works on github

UL > UL

* Top level
  * Second level

       ```
       <android-sdk>/extras/google/google_play_services/libproject/google-play-services_lib/
       ```
  * Another on second level

• ❌ Does not work with kramdown
• works on github

4 spaces indent

OL > UL

1. Top level
  * Second level

    ```
    <android-sdk>/extras/google/google_play_services/libproject/google-play-services_lib/
    ```
  * Another on second level

• ❌ Does not work with kramdown
• works on github

UL > UL

* Top level
  * Second level

    ```
    <android-sdk>/extras/google/google_play_services/libproject/google-play-services_lib/
    ```
  * Another on second level

• ✅ Works with kramdown
• also works on github

leading/trailing newlines

• For Kramdown to work there needs to be exactly 1 newline before in this case, none after (else it creates a new list).

Conclusions

1. Github markdown parser is more permissive than the kramdown parser. This means we can expect issues if we're parsing md files that were written to work on github (unless we switch to use their parser).
2. Fenced code blocks inside nested lists behave in a very nonintuitive & brittle way and are best avoided. The fact that switching the outside/parent list from UL to OL breaks fenced code parsing demonstrates just how brittle this feature is.

I'm not sure how to make it work across all the repos besides simply telling people to learn these rules or avoid fenced blocks in (nested) lists altogether.