The LoopBack documentation includes a number of README files from related repositories, including examples, data source connectors, and components.
Page Contents

LoopBack comprises dozens of GitHub repositories. Beyond the core repositories such as loopback, loopback-datasource-juggler, and loopback-boot, there are dozens of ancillary modules, that fall into three main categories:

  • Components: loopback-component-oauth2, loopback-component-storage, loopback-component-passport, and so on.
  • Connectors: loopback-connector-rest, loopback-connector-mongodb, loopback-connector-soap, dozens of others; see LoopBack data source connectors.
  • Examples: loopback-getting-started, many others; see Tutorials and examples.

Each of these repositories has its own documentation in the repository README file. It makes sense to maintain the documentation there, close to the code, where it can be updated as part of related pull requests to that module. At the same time, it’s useful to aggregate all the documentation on this site. So, essentially we want to keep the module-specific documentation in the README as well as in this repo (loopback.io).

Instead of manually copying the README files from their “home” repositories, we use Bash scripts to automate the process. This enables each repository to maintain its own README and yet also provide the same information in the documentation, with a single source to avoid divergence or duplication of effort.

There are two Bash scripts:

We have a Jenkins pipeline that runs the scripts whenever there is a commit to the loopback.io repository.