-
-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* Create CONTRIBUTING.md Added: Contributing file * Update README.md Updated: Contributing section
- Loading branch information
Showing
2 changed files
with
63 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,62 @@ | ||
# Contributing to StrObj | ||
|
||
We welcome contributions to the StrObj project and are grateful for every kind of help provided. This document provides guidelines for contributing to the StrObj library. | ||
|
||
## Table of Contents | ||
- [Code of Conduct](#code-of-conduct) | ||
- [Getting Started](#getting-started) | ||
- [Submitting Changes](#submitting-changes) | ||
- [Coding Standards](#coding-standards) | ||
- [Pull Request Process](#pull-request-process) | ||
- [Reporting Bugs](#reporting-bugs) | ||
- [Feature Requests](#feature-requests) | ||
|
||
## Code of Conduct | ||
This project adheres to a code of conduct. By participating, you are expected to uphold this code. Please read [Code of Conduct](CODE_OF_CONDUCT.md) for details. | ||
|
||
## Getting Started | ||
Before you begin contributing to StrObj, please take a moment to: | ||
- Familiarize yourself with the [Code of Conduct](CODE_OF_CONDUCT.md). | ||
- Read the documentation and understand the library's functionality. | ||
|
||
## Submitting Changes | ||
1. **Fork the Repository** | ||
- Navigate to the StrObj repository on GitHub and click the "Fork" button. | ||
|
||
2. **Clone the Fork** | ||
- Clone your forked repository to your local machine. | ||
|
||
3. **Create a New Branch** | ||
- Create a branch for your changes: `git checkout -b feature/my-new-feature`. | ||
|
||
4. **Make Your Changes** | ||
- Implement your feature or bug fix. | ||
|
||
5. **Commit Your Changes** | ||
- Commit your changes with a clear commit message. | ||
|
||
6. **Push to the Branch** | ||
- Push your changes to your GitHub repository. | ||
|
||
7. **Create a Pull Request** | ||
- Open a pull request in the original StrObj repository. | ||
|
||
## Coding Standards | ||
- Follow the [PSR-12](https://www.php-fig.org/psr/psr-12/) coding standards. | ||
- Write clear, understandable, and well-documented code. | ||
|
||
## Pull Request Process | ||
- Ensure any install or build dependencies are removed before the end of the layer when doing a build. | ||
- Update the README.md with details of changes to the interface, including new environment variables, exposed ports, useful file locations, and container parameters. | ||
- Increase the version numbers in any examples files and the README.md to the new version that this Pull Request would represent. | ||
|
||
## Reporting Bugs | ||
- Use GitHub Issues to report bugs. | ||
- Clearly describe the issue, including steps to reproduce the bug. | ||
- A code sample or an executable test case demonstrating the problem will help greatly. | ||
|
||
## Feature Requests | ||
- Open an issue with a detailed explanation of the feature you would like to see, and how it would benefit users. | ||
|
||
Thank you for your interest in contributing to StrObj! | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters