1
0
mirror of https://github.com/ianstormtaylor/slate.git synced 2025-05-01 18:28:03 +02:00
slate/Contributing.md
Ian Storm Taylor 677ac96f4f update docs
2016-07-12 22:26:57 -07:00

2.0 KiB

Contributing

Want to contribute to Slate? That would be awesome!

Running Tests

To run the examples, you need to have the Slate repository cloned to your computed. After that, you need to cd into the directory where you cloned it, and install the dependencies from npm.

make install

And then build the source and run the tests:

make dist
make test

And to run the linter:

make lint

If you need to debug something, you can add a debugger line to the source, and then run make test with the DEBUG=true flag enabled.

To keep the source rebuilding on every file change, you need to run an additional watching command:

make watch-dist

Running Examples

To run the examples, you need to have the Slate repository cloned to your computed. After that, you need to cd into the directory where you cloned it, and install the dependencies from npm.

make install

And then build the source and run the examples server:

make dist
make start-examples

If you want to edit the source while running the examples and have those changes immediately reflected, you need to run two additional watching commands in your terminal:

make watch-dist
make watch-examples

Pull Requests

All pull requests are super welcomed and greatly appreciated! Easy issues are marked with an easy-one label if you're looking for a simple place to get familiar with the code base.

Please include tests and docs with every pull request!

Browser Support

Slate aims to targeted all of the modern browsers, and eventually the modern mobile platforms. Right now browser support is limited to the latest versions of Chrome, Firefox, and Safari, but if you are interested in adding support for another modern platform, that is welcomed!