Thank you for your interest in contributing to our work. This guide should help you get started, please let us know if you have any questions.
- Target your pull requests to the version-2 branch
- Add/Update any relevant docs articles in the relevant package's docs folder related to your changes
- Include a test for any new functionality and ensure all existing tests are passing by running
- Ensure tslint checks pass by typing
npm run lint
- Keep your PRs as simple as possible and describe the changes to help the reviewer understand your work
- If you have an idea for a larger change to the library please open an issue and let's discuss before you invest many hours - these are very welcome but want to ensure it is something we can merge before you spend the time :)
If you need to target a PR for version 1, please target the "version-1" branch
Setup your development environment¶
These steps will help you get your environment setup for contributing to the core library.
Install Visual Studio Code - this is the development environment we will use. It is similar to a light-weight Visual Studio designed for each editing of client file types such as .ts and .js. (Note that if you prefer you can use Visual Studio).
Install Node JS - this provides two key capabilities; the first is the nodejs server which will act as our development server (think iisexpress), the second is npm a package manager (think nuget).
On Windows: Install Python v2.7.10 - this is used by some of the plug-ins and build tools inside Node JS - (Python v3.x.x is not supported by those modules). If Visual Studio is not installed on the client in addition to this C++ runtime is required. Please see node-gyp Readme
Install a console emulator of your choice, for Windows Cmder is popular. If installing Cmder choosing the full option will allow you to use git for windows. Whatever option you choose we will refer in the rest of the guide to "console" as the thing you installed in this step.
Install the tslint extension in VS Code:
- Press Shift + Ctrl + "p" to open the command panel
- Begin typing "install extension" and select the command when it appears in view
- Begin typing "tslint" and select the package when it appears in view
- Restart Code after installation
Install the gulp command line globally by typing the following code in your console
npm install -g gulp-cli
Now we need to fork and clone the git repository. This can be done using your console or using your preferred Git GUI tool.
Once you have the code locally, navigate to the root of the project in your console. Type the following command:
npm install - installs all of the npm package dependencies (may take awhile the first time)
Copy settings.example.js in the root of your project to settings.js. Edit settings.js to reflect your personal environment (username, password, siteUrl, etc.).
Then you can follow the guidance in the debugging article to get started testing right away!