Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Create a separate CONTRIBUTING.md #6

Merged
merged 1 commit into from
Jul 4, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
95 changes: 95 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,95 @@
# Contributing to MudBlazor Translations

Thank you for your interest in contributing to MudBlazor Translations! We welcome contributions from the community and appreciate your efforts to improve this project.

## How to Contribute

### 1. Localization

If you want to add or modify translations, please visit our [Weblate project](https://hosted.weblate.org/engage/mudblazor/). Weblate is our translation management platform.

### 2. Reporting Issues

If you encounter a bug or have a feature request, please create an issue on GitHub. When reporting an issue, please include:

- A clear and descriptive title.
- A detailed description of the problem or suggestion.
- Steps to reproduce the issue (if applicable).
- Any relevant logs or screenshots.

### 2. Code Contributions

If you intend to contribute to the code itself, please follow the instructions below:

#### Fork the Repository

Before you start working on a feature or a bugfix, fork the repository to your GitHub account:

1. Navigate to the [MudBlazor Translations repository](https://github.com/MudBlazor/Translations).
2. Click the "Fork" button in the upper right corner.

#### Clone the Repository

Clone the forked repository to your local machine:

```bash
git clone https://github.com/MudBlazor/Translations.git
cd Translations
```

#### Create a Branch

Create a new branch for your work. Use a descriptive name for your branch:

```bash
git checkout -b feature/your-feature-name
```

#### Make Your Changes

Make your changes to the codebase. Ensure that your changes are well-documented and include appropriate tests where applicable.

#### Commit Your Changes

Commit your changes with a clear and concise commit message:

```bash
git add .
git commit -m "Add new feature: your feature description"
```

#### Push to GitHub

Push your changes to your forked repository:

```bash
git push origin feature/your-feature-name
```

#### Create a Pull Request

Navigate to the original repository and create a pull request:

1. Go to the [pull requests section](https://github.com/MudBlazor/Translations/pulls) of the original repository.
2. Click "New pull request".
3. Select your branch from the "compare" dropdown.
4. Provide a clear title and description for your pull request.
5. Click "Create pull request".

## Code of Conduct

This project adheres to the Contributor Covenant [code of conduct](CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code. Please report unacceptable behavior to the project maintainers.

## Style Guide

Please follow the project's coding style and conventions. Consistent code style helps maintain readability and ease of maintenance.

## License

By contributing to MudBlazor Translations, you agree that your contributions will be licensed under the [MIT License](LICENSE).

## Getting Help

If you need help or have any questions, feel free to open an issue on GitHub or reach out to the maintainers.

Thank you for your contributions!
13 changes: 9 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@
[![NuGet](https://img.shields.io/nuget/v/MudBlazor.Translations.svg)](https://www.nuget.org/packages/MudBlazor.Translations)
[![NuGet](https://img.shields.io/nuget/dt/MudBlazor.Translations.svg)](https://www.nuget.org/packages/MudBlazor.Translations)
[![Translation status](https://hosted.weblate.org/widget/mudblazor/svg-badge.svg)](https://hosted.weblate.org/engage/mudblazor/)
[![Discord](https://img.shields.io/discord/786656789310865418?color=%237289da&label=Discord&logo=discord&logoColor=%237289da&style=flat-square)](https://discord.gg/mudblazor)

# MudBlazor.Translations

Expand Down Expand Up @@ -42,11 +43,15 @@ documentation page.

[![Translation status](https://hosted.weblate.org/widget/mudblazor/multi-auto.svg)](https://hosted.weblate.org/engage/mudblazor/)

## License

This project is licensed under the MIT License. See the [LICENSE](https://choosealicense.com/licenses/mit/) file for details.

## Contributing

If you want to contribute to the translations, please visit
the [Weblate project](https://hosted.weblate.org/engage/mudblazor/).
Contributions are welcome! Please see the [CONTRIBUTING](CONTRIBUTING.md) guide for more details.

## License
## Contact

For questions or support, please open an issue on this repository.

Distributed under the [MIT License](https://choosealicense.com/licenses/mit/). See `LICENSE` for more information.