Skip to content

Commit

Permalink
Merge pull request #248 from cloudinary-devs/revert-247-244-FixContri…
Browse files Browse the repository at this point in the history 
…butingReadme

Revert ""docs: fixed internal links and overall refactoring of Contributing.md"
  • Loading branch information
@olavea
olavea committed Oct 11, 2023
2 parents 901005a + 83347d8 commit 942dd76
Showing 1 changed file with 26 additions and 27 deletions.
53 changes: 26 additions & 27 deletions CONTRIBUTING.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -6,15 +6,15 @@ Our community looks forward to your contributions 🎉

## How can you help?

You can help make [documentation](#improving-the-documentation) clearer, help [fellow users](#i-have-a-question), report [bugs](#reporting-bugs), suggest [enhancements](#suggesting-enhancements) or [contribute code](#your-code-contribution).
You can improve [documentation](#improving-the-documentation), help [fellow users](#i-have-a-question), report [bugs](#reporting-bugs), suggest [enhancements](#suggesting-enhancements) or [contribute code](#your-first-code-contribution).

## Why do we need your help?

As a user, you know how to make the Cloudinary Transformer Plugin developer experience better for a user like you 👊
As a user, you know best how to make the Cloudinary Transformer Plugin better for users like you 👊

## You can support the plugin in other ways
## Other ways to support the plugin

If you like the plugin but don't have much time to spare, there are quick ways to support the plugin and show your appreciation:
If you like the plugin but don't have time to contribute, there are other ways to support the plugin and show your appreciation:

⭐️ Star the GitHub repository\
🐦 Write a tweet and mention the plugin and tag @cloudinary\
Expand All @@ -31,7 +31,7 @@ If you like the plugin but don't have much time to spare, there are quick ways t
- [I Want To Contribute](#i-want-to-contribute)
- [Reporting Bugs](#reporting-bugs)
- [Suggesting Enhancements](#suggesting-enhancements)
- [Your Code Contribution](#your-code-contribution)
- [Your First Code Contribution](#your-first-code-contribution)
- [Improving The Documentation](#improving-the-documentation)
- [Release Process](#release-process)
- [Additional Notes](#additional-notes)
Expand All @@ -51,27 +51,27 @@ If you like the plugin but don't have much time to spare, there are quick ways t

## I Have a Question

The guide for submitting a **question**. If you follow this guide, you help our maintainers and the community to answer your question as fast as possible. Or you can answer a question if you like, that would be super helpful.
The guide for submitting a **question**. Following the guidelines helps us (maintainers and the community) to answer your question as fast as possible.

### Before you ask a question
### Before asking a question

Read the documentation. Both for the [plugin](https://github.com/cloudinary-devs/gatsby-transformer-cloudinary/blob/main/README.md) and [Cloudinary in general](https://cloudinary.com/documentation).
Look through existing questions both on the [plugin's discussion board](https://github.com/cloudinary-devs/gatsby-transformer-cloudinary/discussions) and in the [Cloudinary Community](https://community.cloudinary.com/).
Look through existing questions both on the plugin's discussion board](https://github.com/cloudinary-devs/gatsby-transformer-cloudinary/discussions) and in the [Cloudinary Community](https://community.cloudinary.com/).

#### How Do I Submit a Good Question?

- Start a [discussion](https://github.com/cloudinary-devs/gatsby-transformer-cloudinary/discussions) in the repo for plugin-specific questions or start a thread in the [Cloudinary Community](https://community.cloudinary.com/) for other Cloudinary questions.
- Use a **clear and descriptive title** to identify your question.
- **Describe your question** including as many details as you can.
- Include **screenshots and/or animated GIFs** if you can.
- If relevant **include screenshots and/or animated GIFs** to enhance the question.

 

## I Want To Contribute

### Reporting Bugs

The guide for submitting a **bug report**. If you follow this guide, you help our maintainers and the community to understand the problem and come up with a fix.
The guide for submitting a **bug report**. Following the guidelines helps us (maintainers and the community) to understand the problem and come up with a fix.

#### Before Submitting a Bug Report

Expand All @@ -86,23 +86,23 @@ Jump to ["I Have a Question"](#i-have-a-question) if you need help or support.

We track bug reports as [Github issues](https://github.com/cloudinary-devs/issues).

- Open an [Issue](https://github.com/cloudinary-devs/gatsby-transfomer-cloudinary/issues/new).
- Use a **clear and descriptive title** to identify the bug.
- Describe **step-by-step** how to reproduce the bug. Include as many details as you can. Don't just say **what** you did, but explain **how** you did it.
- Describe the **current behavior** and explain the **behavior you expected instead** and why.
- Open an [Issue](https://github.com/cloudinary-devs/gatsby-transformer-cloudinary/issues/new).
- **Use a clear and descriptive title** to identify the bug.
- Describe **step-by-step** how to reproduce the bug. Include as many details as you can. Don't just say what you did, but explain how you did it.
- **Describe the current behavior** and **explain the behavior you expected instead** and why.
- If possible **provide an example** to reproduce the bug. Include links to files, GitHub projects, or include copy/pasteable snippets.
- If you provide code snippets, use [Markdown code blocks](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks).
- Include **screenshots and/or animated GIFs** if you can.
- If relevant **include screenshots and/or animated GIFs** to enhance the bug report.

⚠️ **DO NOT INCLUDE** your Cloudinary API Secret or other sensitive information.
⚠️ Do _not_ include your Cloudinary API Secret or other sensitive information.

### Suggesting Enhancements

The guide for submitting an enhancement suggestion, both **new feature and minor improvement ideas**. If you follow this guide, you help our maintainers and the community to understand your suggestion and follow up on it.
The guide for submitting an enhancement suggestion, both **new feature and minor improvement ideas**. Following the guidelines helps us (maintainers and the community) to understand your suggestion and follow up on it.

#### Before Submitting an Enhancement

- Use the [latest version](https://github.com/cloudinary-devs/gatsby-transformer-cloudinary/releases) of the plugin.
- Use the [latest version](https://github.com/cloudinary-devs/gatsby-transformer-cloudinary/releases).
- Reread the [readme](https://github.com/cloudinary-devs/gatsby-transformer-cloudinary/blob/main/README.md). Maybe your idea is already possible with a different configuration?
- Perform a [search](https://github.com/cloudinary-devs/gatsby-transformer-cloudinary/issues) and see if someone has already suggested your idea. If so, commenting on the existing issue is better than opening a new issue

Expand All @@ -113,14 +113,13 @@ We track enhancement ideas as [Github issues](https://github.com/cloudinary-devs
- Open an [Issue](https://github.com/cloudinary-devs/gatsby-transformer-cloudinary/issues/new).
- Use a **clear and descriptive title** to identify your idea.
- **Describe your idea** including as many details as you can.
- Describe the **current behavior** and explain the **behavior you would like instead** and why.
- Include **screenshots and/or animated GIFs** if you can.
- Explain why your **idea is useful** to most plugin users.

- **Describe the current behavior** and **explain the behavior you would like instead** and why.
- If relevant **include screenshots and/or animated GIFs** to enhance the description.
- **Explain why your idea is useful** to most plugin users.

### Your Code Contribution

The guide for submitting your **code contribution**. If you follow this guide, you increase the chance of getting your code released.
The guide for submitting your **code contribution**. Following the guidelines increase the chance of getting your code released.

If you are new to open-source code contributions, start with these links:

Expand All @@ -131,8 +130,8 @@ Unsure where you can best start contributing code? Look through these ["good fir

#### Before You Start Contributing

- Add a comment to an existing [issue](https://github.com/cloudinary-devs/gatsby-transformer-cloudinary/issues), indicating your interest,
- or create a new [issue](https://github.com/cloudinary-devs/gatsby-transformer-cloudinary/issues/new), describing what you'd like to contribute.
- Add a comment to an existing [issue](https://github.com/cloudinary-devs/gatsby-transformer-cloudinary/issues) indicating your interest,
- or create a new [issue](https://github.com/cloudinary-devs/gatsby-transformer-cloudinary/issues/new) describing what you'd like to contribute.

In both cases, outline your action plan and wait for feedback before spending too much time coding your solution in case your action plan is not within the scope/goals of this plugin.

Expand Down Expand Up @@ -201,7 +200,7 @@ Improvements to both are very much encouraged 🙏

You may follow the guide for [Your First Code Contribution](#your-first-code-contribution) or make changes directly from Github.

- [Edit the README.md](https://github.com/cloudinary-devs/gatsby-transformer-cloudinary/edit/main/README.md) directly on Github
- [Edit the README.md](https://github.com/cloudinary-devs/gatsby-transformer-cloudinary/blob/main/README.md) directly on Github
- [Edit the CONTRIBUTING.md](https://github.com/cloudinary-devs/gatsby-transformer-cloudinary/edit/main/CONTRIBUTING.md) (this text) directly on Github

 
Expand All @@ -214,4 +213,4 @@ Our plugin use [conventional commits](https://www.conventionalcommits.org/en/v1.

## Credit

This guide is based on the **contributing-gen**. [Make your own](https://github.com/bttger/contributing-gen) CONTRIBUTING.md today!
This guide is based on the **contributing-gen**. [Make your own](https://github.com/bttger/contributing-gen)!

0 comments on commit 942dd76

Please sign in to comment.