Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Contributing to LoLs
Start by talking about Language of Languages (LoLs)
- Talk to us on the
- Join our Google mailinglist
- Follow @LoLsWorkbench on Twitter
- Join our Google+ Language of Languages Circle
- Talk to us on our #languagesoflanguages IRC channel
Setup your Language of Languages (LoLs) clone
There are several repositories for the Language of Languages project. They are as follows:
- jamiedouglass.github.io contains the project website for Language of Languages
To get your clone for development, follow this list:
- Create a personal GitHub account and install a Git client
- Fork the Language of Languages repository in which you are interested
- Clone the fork to a local directory on your computer
Now you should be able to start work on Language of Languages using a text editor and commit changes to your local disk directory.
If you think Language of Languages works differently than you expected, you can start by asking on our gitter room, IRC or the Mailinglist. Please make sure that you have first checked the following guides:
TODO add links to the pages
- Getting Started
- Writing My First Application
- LoLs FAQ
If the issue can not be resolved you should file an issue on the tracker for the respective GitHub repository.
Before reporting an issue, try to reduce the issue to the bare minimum required to reproduce it. This allows us to track down and fix the issue in an easier and faster way.
Additionally, you should give us enough information to reproduce the issue. Therefore, include versions of your OS, and LoLs as well as sample code. If you don't list the exact steps required to reproduce the issue we won't be able to fix it.
Afterwards, report the issue on one of the following trackers:
Developing Language of Languages (LoLs)
Check out the Language of Languages Wiki for more information about LoLs architecture and our development plans.
Creating a Pull Request
The LoLs development model currently revolves around Pull Requests which are created through GitHub
- Update to latest LanguageOfLanguages master (git pull)
- Develop your feature or bugfix in a local branch (not in master)
- Create unittest for your feature or bugfix (your feature/fix will be integrated a lot faster if unittests are present)
- Enhance/fix LoLs
- Run the unit tests
- Commit your changes when all tests are green
- Try to split your fix into small Git commits if multiple changes are involved (this makes it easier for us to review the changes)
- Make sure to reflection any changes in the Language of Languages documentation
- Push the changes to your fork on GitHub git push
- Submit Pull Request (usually for the LanguageOfLanguages master branch)
Submit Contributors Agreement
All contributions accepted by Research on Knowing, LLC for the Language of Languages (LoLs) project are licensed using either the Harmony Individual License Agreement or the Harmony Entity License Agreement. Contributors retain the copyright for the work they contribute while licensing us to use their contributions.
- If you are an individual contributor, please submit the Individual Agreement
- If you are a legal entity such as a company,please submit the Entity Agreement
The agreements must be signed and emailed to the following:
What if your including work from other Open Source Software projects in your contribution? If you don't own the copyright for everything in your contributing, you must include the license as a part of your contribution. Make sure to explain what code is covered by which license.