From c438c4d14ba145cff08ebca55a0944f8b5f85bbe Mon Sep 17 00:00:00 2001
From: savindi7 <savindi@wso2.com>
Date: Thu, 1 Feb 2024 12:08:56 +0530
Subject: [PATCH] docs: add PR and issue creation guidelines

---
 CONTRIBUTING.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 91e7bea1..5a35d971 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -8,6 +8,8 @@ As a contributor, here are the guidelines we would like you to follow:
  - [Designing](#designing)
  - [Versioning](#versioning)
 
+You can contribute to the library by reviewing and providing comments on [pull requests](https://github.com/wso2/oxygen-ui/pulls) and [issues](https://github.com/wso2/oxygen-ui/issues), enhancing our [documentation](https://github.com/wso2/oxygen-ui/tree/main/docs/website), resolving bugs, or introducing new features through pull requests.
+
 ## Setting Up Development Environment
 
 Follow this guide to set up the source code, development tools & other software.
@@ -129,6 +131,14 @@ From the root of the project, execute the following command to build the project
 pnpm build
 ```
 
+## Creating an issue
+
+- Issues can be [created](https://github.com/wso2/oxygen-ui/issues/new/choose) for bugs, improvements and features.
+- The fields in the issue template must be filled in detail. Add N/A if not applicable.
+- Add necessary labels to facilitate filtering and grouping.
+
+[Example issue](https://github.com/wso2/oxygen-ui/issues/203)
+
 ## Commit Message Guidelines
 
 *This specification is inspired by and supersedes the [AngularJS commit message format][commit-message-format].*
@@ -263,6 +273,24 @@ The content of the commit message body should contain:
 - Information about the SHA of the commit being reverted in the following format: `This reverts commit <SHA>`.
 - A clear description of the reason for reverting the commit message.
 
+## Creating a PR
+
+Once you [set up the development environment](#setting-up-development-environment), 
+1. Create a new branch:
+
+```bash
+git checkout -b my-topic-branch
+```
+2. Make changes, commit, and push to your fork:
+
+```bash
+git push -u origin HEAD
+```
+3. Go to the [repository](https://github.com/wso2/oxygen-ui) and open a pull request.
+4. The fields in the PR description template must be filled in detail. Add N/A if not applicable.
+
+The team regularly reviews new pull requests, deciding to merge, request changes, or close with an explanation.
+
 ## Designing
 
 Designers working on the Oxygen UI Design System should use Figma as the source of truth for design assets and utilize Figma Tokens for creating design components. [Figma Tokens](https://tokens.studio/) is a tool that allows designers to create a set of standardized design variables (e.g., colors, typography, spacing) that can be reused across various design projects.