- Getting Started
- Migrating from v0 to v1
- Playground alpha
Hi! 👋 We’re excited that you’re interested in contributing! Take a moment to read the following guidelines. And thanks for contributing to MDX! 👏👌✨
If you’re raising an issue, please understand that people involved with this project often do so for fun, next to their day job; you are not entitled to free customer service.
- Running the tests
- Submitting an issue
- Submitting a pull request
- Project structure
Please chat and ask questions on spectrum! Jump in there and lurk, talk to us, and help others.
Help us help you!
Spending time framing a question and adding support links or resources makes it much easier for us to help. It’s easy to fall into the trap of asking something too specific when you’re close to a problem. Then, those trying to help you out have to spend a lot of time asking additional questions to understand what you are hoping to achieve.
Spending the extra time up front can help save everyone time in the long run.
- Try to define what you need help with:
- Is there something in particular you want to do?
- What problem are you encountering and what steps have you taken to try and fix it?
- Is there a concept you’re not understanding?
- Learn about the rubber duck debugging method
- Avoid falling for the XY problem
- Search on GitHub and Spectrum to see if a similar question has been asked
- Read through the Getting Started Guide
- If possible, provide sample code, a CodeSandbox, or a video
- The more time you put into asking your question, the better we can help you
There’s several ways to contribute, not just by writing code.
It’s possible to support us financially by becoming a backer or sponsor of unified through Open Collective. With this support, we can pay for project leadership, finance non-coding work, or to do fun things for the community like getting stickers for contributors. You’ll be helping unified’s maintainers manage and improve existing projects, and additionally support our work to develop new and exciting projects, such as micromark.
As a user of this project you’re perfect for helping us improve our docs. Typo corrections, error fixes, better explanations, new examples, etcetera. Anything!
Some issues lack information, aren’t reproducible, or are just incorrect. Help make them easier to resolve.
We’re always looking for more opinions on discussions in the issue tracker.
Code contributions are very welcome. It’s often good to first create an issue to report a bug or suggest a new feature before creating a pull request to prevent you from doing unnecessary work.
Tests for an individual package can be run as a yarn workspace:
yarn workspace remark-mdx test. To see what packages ar available to test
you can list out all workspaces with
yarn workspaces info.
- The issue tracker is for issues. Use chat for support
- Search the issue tracker (including closed issues) before opening a new issue
- Ensure you’re using the latest version of our packages
- Use a clear and descriptive title
- Include as much information as possible: steps to reproduce the issue, error message, version, operating system, etcetera
- The more time you put into an issue, the better we will be able to help you
- The best issue report is a failing test proving it
- Non-trivial changes are often best discussed in an issue first, to prevent you from doing unnecessary work
- For ambitious tasks, you should try to get your work in front of the community for feedback as soon as possible
- New features should be accompanied with tests and documentation
- Don’t include unrelated changes
- Test before submitting code by running
- Write a convincing description of why we should land your pull request: it’s your job to convince us
MDX is a monorepo that uses lerna.
- All packages are found in
- All documentation is found in
./docsand can be viewed with
yarn docs -- -o
- There’s an
./examplesdirectory where examples for different tools and frameworks
In order to release a new version you can follow these steps:
- Draft a release for the next version (vX.X.X)
- Release a prerelease
yarn lerna publish
- Select prepatch/preminor/premajor
- Sanity check in a project or two with the prerelease
yarn lerna publish
- Publish release on GitHub
If you’re having issues installing locally you might need to run
yarn lerna exec yarn install instead of