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

feat: create CONTRIBUTING.md #2254

Merged
merged 11 commits into from
Oct 5, 2023
47 changes: 47 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
# How to contribute?
## Pre-requisites
FlorentLvr marked this conversation as resolved.
Show resolved Hide resolved
Open a free account on Naas Cloud so we can test the templates in a similar environment.
FlorentLvr marked this conversation as resolved.
Show resolved Hide resolved
Register for the Contributor Program so we can add you to the team of contributors in the Naas GitHub organization. To start working on our repository, you must be a part of our open-source contributors team. Please check your email and validate the invitation before you begin working on a new issue.
Create your GitHub personal access token. Select “No expiration” and tick only the first section repository and keep your token safe as you won’t be able to generate it again.

## Step 1: Create or Select an Issue
Identify or propose an issue you wish to work on. It could be a snippet of Python code, an API integration with a tool you are using, or an automation leveraging existing templates with our scheduler, asset, or webhook features. Before you begin working on it, prepare the issue:

Ensure the description is clear.
Tag yourself in the Assignees section.
Change the status to 'In Progress' in the Projects section/Community Roadmap.
Create a branch in the Development section.

## Step 2: Technical Setup
Clone the awesome-notebooks repository on your Naas Cloud account and switch to the branch you created.

Create a folder named with the source tool (if it's not already created).
Copy and paste template.ipynb at the root of the folder inside the folder you are working on, and start working on your notebook.

## Step 3: Work on Your Notebook
Start working on your notebook. Commit your work every time you make significant progress. You can use the UI interface inside your Naas lab server to do this.

All new files will be found in the untracked section, all modified files in the unstaged section.
Once you want to commit, add your notebook to staged by clicking on the + and create a commit message. We recommend following the commit convention and starting your message with “feat:” if it's an improvement or “fix:” if it's a bug fix, followed by a clear commit message. Here are some examples:
feat: update tags, author, and description
feat: developing function in model to…
fix: adding try except to manage error on…
Once you're satisfied with the result, push to the branch by clicking on the icon on top (make sure you use a GitHub personal access token and not a password, otherwise, it won’t work).
Ensure the notebook respects the framework.

## Step 4: Open a Pull Request
Open a Pull Request and add a core team member as Reviewer (Florent, Maxime, or Jeremy).

Change the status of this Issue to “Review” in the Projects section and comment on the Pull Request with a brief summary of what you've done.
You will now discuss your work on the PR. If any changes are made, ensure you pull the branch before working on it again by clicking on the button at the top.
Expect feedback and merge within the next 24-72 hours.

## Step 5: Promote Your Work
Once merged, promote your work on LinkedIn, Twitter, and other social media channels! (Optional, but people need to know you are awesome 😉). Explain why you did this notebook and how it could be useful. You can use the certificate generated once the PR is merged to display your work and add the tag open source contributor on your LinkedIn profile. We will be happy to have you in our community.

Thank you!

## Step 6: Become a Templates Maintainer
If you want to contribute more frequently to Naas, you can become a templates maintainer. This status will offer you the right to be sponsored by Naas for your contributions done every month, ranging from $50 to $250. To become a templates maintainer, you must have completed at least 5 notebooks (which ensures you've mastered our process) and created 5 social media content promoting your template or Naas.

Then, you will be introduced to our template maintainer program and will have a dedicated team with the core team to assist you in developing integrations, automations, or AI systems.
Loading