Skip to content

Latest commit

 

History

History
71 lines (40 loc) · 3.58 KB

CONTRIBUTING.md

File metadata and controls

71 lines (40 loc) · 3.58 KB

Welcome to Gatsby Plugin Starter docs contributing guide

Thank you for your interest in contributing to gatsby-source-airtable-next.

Both code and other types of contributions are welcome.

Getting started

  • Read our Code of Conduct to keep our community approachable and respectable.
  • Read the README to get an overview of the project.
  • Browse the issues and discussions already taking place to familiarize yourself with the state of the project.

Contribute with code

You may either solve an exciting issue, or create a new issue.

Either way, make sure to outline your plan of action and get some feedback before spending too much time on your solution.

If you are new to open source code contributions, here are some links to get you started:

Fork, Clone and Install

  1. Fork this repository
  2. Clone the fork to your local machine: git clone /[email protected]:davidpaulsson/gatsby-source-airtable-next.git
  3. Move into repo folder: cd gatsby-source-airtable-next
  4. Install packages: yarn install

Yarn Workspace

The project uses yarn workspace to host the plugin and demo codes in one repository.

When installing dependencies, make sure to include workspace plugin or workspace demo to the command so that dependencies are added to the correct workspace: yarn workspace plugin add lodash.

Important note from the yarn workspace docs:

Be careful when publishing packages in a workspace. If you are preparing your next release and you decided to use a new dependency but forgot to declare it in the package.json file, your tests might still pass locally if another package already downloaded that dependency into the workspace root. However, it will be broken for consumers that pull it from a registry, since the dependency list is now incomplete so they have no way to download the new dependency. Currently, there is no way to throw a warning in this scenario.

Development

Run demo: yarn develop

[TODO] Project structure [TODO] Style guide

Testing

[TODO] Add a test and document

Pull Request

When finished with the changes, create a pull request, also known as a PR.

[TODO] How to name the PR [TODO] Only squash merge allowed

Semantic Release

The project uses conventional commits and semantic versioning to automate releases by utalizing the semantic-release project.

Contribute in other ways

Questions, Feedback and Suggestions

If you have any questions, feedback or suggestions head on over to discussions.

Found a bug?

If you find a bug please open an issue and/or create a pull request to fix it.