The idea of this project is to combine all the information related to cats into one website - whether it be about tips for owning a cat as a pet, learning cat history, all cat products, you name it.
Feel free to contribute and create new issues for any feedback, or questions you have! This is a project about everything and anything related to cats, so feel free to explore!
- Feel free to open new issues and comment on existing ones if you want to take on tasks. Help is always welcomed!
Thanks for visiting Cat Docs!
Set up the project locally by following these steps:
-
Fork the Repository:
- Click the "Fork" button at the top-right corner of the repository page to create a copy of the repository under your own GitHub account.
-
Clone Your Fork:
- Clone the forked repository to your local machine using the following command:
Replace
git clone https://github.com/your-username/cat-docs.git
your-username
with your GitHub username.
- Clone the forked repository to your local machine using the following command:
-
Navigate to the Project Directory:
cd cat-docs
-
Install Dependencies:
- Install the required dependencies using the package manager of your choice. For example, with npm:
npm install
- Install the required dependencies using the package manager of your choice. For example, with npm:
-
Run the Project:
- Start the project using the VitePress command to ensure everything is working correctly:
npm run docs:dev
- Start the project using the VitePress command to ensure everything is working correctly:
-
Browse the Issues:
- Look through the issues to find one that interests you. Comment on the issue to let the maintainers know you'd like to work on it. The issue will then be assigned to you.
-
Create a Branch:
- Create a new branch for your work. Use a descriptive name that relates to the issue you're addressing. For example:
git checkout -b issue-123-add-cat-facts
- Create a new branch for your work. Use a descriptive name that relates to the issue you're addressing. For example:
-
Make Your Changes:
- Implement your changes and commit them to your branch. Follow the project's coding standards and commit message guidelines.
-
Push Your Branch:
- Push your branch to your forked repository:
git push origin issue-123-add-cat-facts
- Push your branch to your forked repository:
-
Submit a Pull Request (PR):
- Go to the original repository on GitHub and you should see a prompt to create a pull request. Click "Compare & pull request".
-
PR Review and Approval:
- Your pull request will be reviewed by the maintainers. Please be patient and responsive to any feedback you receive. Only maintainers have the authority to merge and deploy your changes.
For more detailed information about working with forks and contributing to open-source projects, check out GitHub's guide on working with forks.