Contributing
Last updated
Last updated
Want to contribute to Slate? That would be awesome!
If you run into any weird behavior while using Slate, feel free to open a new issue in this repository! Please run a search before opening a new issue, to make sure that someone else hasn't already reported or solved the bug you've found.
Any issue you open must include:
A that reproduces the bug with a minimal setup.
A GIF showing the issue in action. (Using something like .)
A clear explanation of what the issue is.
Please use the Slack instead of asking questions in issues, since we want to reserve issues for keeping track of bugs and features. We close questions in issues so that maintaining the project isn't overwhelming.
Please include tests and docs with every pull request!
To run the tests, you need to have the Slate repository cloned to your computer. After that, you need to cd into the directory where you cloned it, and install the dependencies with yarn and build the monorepo:
Then run the tests with:
To keep the source rebuilding on every file change, you need to run an additional watching command in a separate process:
If you need to debug something, you can add a debugger line to the source, and then run yarn test debug.
If you only want to run a specific test or tests, you can run yarn test --fgrep="slate-react rendering" flag which will filter the tests being run by grepping for the string in each test.
To run the benchmarks, first make some changes to the source that you want to benchmark. Now that you're ready, you need to save a "baseline" for what the performance was before you made you change.
To do that, stash your changes and save the benchmarks:
Then once the reference has been saved, unstash your changes and run the benchmarks to see a comparison:
There will be some subtle changes in iteration speed always, but the comparison reporter will highlight any changes that seem meaningful. You can run benchmark multiple times to ensure the speed up persists.
To run selected benchmarks, create tmp/benchmark-config.js with module.exports.include. For example, to run slate-core benchmarks only with get-*, we can create a tmp/benchmark-config.js as
And follow the prompts Lerna gives you.
Here's a to get you started:
We've also got a where you can ask questions and get answers from other people using Slate:
All pull requests are super welcomed and greatly appreciated! Issues in need of a solution are marked with a label if you're looking for somewhere to start.
Check out the to see how to get the examples running locally!
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 , , and , but if you are interested in adding support for another modern platform, that is welcomed!
detailing how to test various input scenarios on Windows, Mac and Linux.
Slate makes use of to log information about various methods. You can by setting localStorage.debug = "*" (to log methods on all modules) or to a single namespace (e.g. slate:editor). Look for const debug = Debug('<namespace>') to get the namespace of various modules.
Since we use to manage the Slate packages this is fairly easy, but you must make sure you are using npm to run the release script, because using yarn results in failures. So just run:
