How LoopBack documentation works
LoopBack documentation is sourced in the strongloop/loopback.io
GitHub repository, and this site is generated using Jekyll and GitHub pages. The site is published from the gh-pages branch. Don’t use the master branch.
All the pages are in the pages directory. Every page also has an Edit this page button at the bottom
that links to the page in the GitHub repo.
For information on contributing to translations in languages other than English, see Translation.
To contribute a change
Follow these steps:
- Click on Edit this page (top of page) to fork the repo.
- Edit the page or pages as needed.
- Commit to your fork/branch.
- Open a PR for your changes. If there is an associated issue, please reference it in your PR.
Important: When you submit your PR, be sure to agree to the contributor license agreement; see below.
We attempt to review and merge PRs as soon as possible; in general, we’ll try to do so within 24 hours during the business week. Please allow longer over weekends or holidays.
Agreeing to the CLA
Like many open source projects, you must agree to the contributor license agreement (CLA) before we can accept (merge) your changes.
In summary, by submitting your code or doc contributions, you are granting us a right to use that code/content under the terms of this agreement, including providing it to others. You are also certifying that you wrote it, and that you are allowed to license it to us. You are not giving up your copyright in your work. The license does not change your rights to use your own contributions for any other purpose.
Contributor License Agreements are important because they define the chain of ownership of a piece of software. Some companies won’t allow the use of free software without clear agreements around code ownership. That’s why many open source projects collect similar agreements from contributors. The LoopBack CLA is based on the Apache CLA.
What to work on
We use GitHub issues to track tasks and bugs. In general:
- For issues around documentation content (that is the actual information), open an issue in the relevant repository, such as
loopback,loopback-datasource-juggler,loopback-connector-xxx, and so on. - For issue around the documentation site, layout, or UX, open an issue in the loopback.io repository.
For general guidelines on creating issues, see Reporting issues.
It is best practice to search first to make sure someone else hasn’t already logged your issue. Run these helpful GitHub queries to see open documentation issues:
- Open documentation issues in any strongloop repository.
- Open issues labeled “needs doc”: these are typically code issues that need to be documented, as opposed to specific doc tasks/problems.
References
The site theme is derived from Tom Johnson’s Documentation Theme for Jekyll. We’ve modified and extended it substantially to suit our needs. For more information, see the other pages in this section.
Other technical references: