Thank you for considering contributing to Matro UI Documentation! This guide will help you get started with building the documentation locally and making contributions.
Before you can contribute to the documentation, ensure that you have the following installed on your machine:
- Node.js (v14.x or higher)
- npm (v7.x or higher) or yarn (v1.x or higher)
-
Fork the Repository: Fork the Matro UI Documentation repository to your GitHub account by clicking the "Fork" button at the top right of the repository page.
-
Clone the Repository: Clone your fork of the repository to your local machine using the following command:
git clone https://github.com/matro-ui/matro-ui.github.io.git
-
Navigate to the Project Directory: Change your current directory to the cloned repository:
cd matro-ui.github.io
-
Install Dependencies: Install the project dependencies using npm or yarn:
npm install # or yarn install
To build and run the documentation site locally, use the following steps:
-
Start the Development Server: Run the following command to start the local development server:
npm run start # or yarn start
-
View the Documentation: Once the development server is running, open your web browser and navigate to
http://localhost:3000
to view the documentation site. -
Make Changes: Make changes to the documentation content located in the
docs
directory. The site will automatically update with your changes as you save the files.
If you'd like to contribute to the documentation, follow these steps:
-
Create a Branch: Create a new branch for your changes:
git checkout -b feature/new-feature
-
Make Changes: Make your desired changes to the documentation.
-
Commit Changes: Commit your changes to your branch:
git commit -am "Add new feature documentation"
-
Push Changes: Push your changes to your forked repository:
git push origin feature/new-feature
-
Create a Pull Request: Once your changes are pushed to your forked repository, create a pull request against the
main
branch of the original repository.
- The Matro UI Documentation is based on Docusaurus that is MIT Licensed.
- The Matro UI .md files (e.g., .md files in the /docs or any other folder) is Creative Commons licensed.
By contributing to Matro UI Documentation, you agree that your contributions will be licensed under the MIT License.