From ff145f61690c9e2b5eab2c366ef93423763bb5fa Mon Sep 17 00:00:00 2001 From: FlorentLvr <48032461+FlorentLvr@users.noreply.github.com> Date: Thu, 5 Oct 2023 09:49:19 +0200 Subject: [PATCH 01/11] feat: create CONTRIBUTING.md --- CONTRIBUTING.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 47 insertions(+) create mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000000..c539132ad1 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,47 @@ +# How to contribute? +## Pre-requisites +Open a free account on Naas Cloud so we can test the templates in a similar environment. +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. From 1bbb5cadde7ec6363c778bd9873d8f12bb07770f Mon Sep 17 00:00:00 2001 From: Sriniketh J <81156510+srini047@users.noreply.github.com> Date: Thu, 5 Oct 2023 14:55:48 +0530 Subject: [PATCH 02/11] fix: changes in link and structure --- CONTRIBUTING.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index c539132ad1..3b391dbea3 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,8 +1,9 @@ # How to contribute? ## Pre-requisites -Open a free account on Naas Cloud so we can test the templates in a similar environment. -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. +- Create a free account on [Naas Cloud](http://app.naas.ai/) so we can test the templates in a similar environment and be on the same page. +- 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](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-personal-access-token-classic). 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: From babeafab7f2c7d4cbfb87e0382e1577a7249f148 Mon Sep 17 00:00:00 2001 From: FlorentLvr <48032461+FlorentLvr@users.noreply.github.com> Date: Thu, 5 Oct 2023 17:12:19 +0200 Subject: [PATCH 03/11] feat: update README_template.md with docs from site --- README_template.md | 145 +++++++++++++++++++++++++++++---------------- 1 file changed, 94 insertions(+), 51 deletions(-) diff --git a/README_template.md b/README_template.md index 8af4438cc2..aa6a5586b0 100644 --- a/README_template.md +++ b/README_template.md @@ -1,78 +1,121 @@ -# Naas Templates [![Awesome](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)](https://github.com/sindresorhus/awesome) -(aka the "awesome-notebooks") +# Naas Templates +## About our templates -## What is Naas ? +Our templates constitute the most extensive collection of open-source notebooks currently available. They encompass a wide range of tools, technologies, and libraries, featuring snippets of notebooks, notebooks for automation and analytics, and others that harness the power of AI. -Naas is an all-in-one data platform that enable anyone with minimal technical knowledge to turn Jupyter Notebooks into powerful automation, analytical and AI data products thanks to low-code formulas and microservices.
+Each of these templates adheres to a consistent framework, designed to expedite your coding process. While these templates are designed for ease of use, some may require data science skills for setup, particularly those that interface with third-party tools via API. These templates can function independently, but they also serve as integral components of data products. Consider them as the essential parts needed to assemble your 'car engine'. By developing these templates and ensuring their standalone functionality, we streamline the process of data product development, as we already comprehend the operation of some parts within it. -The platform is based on 3 low-code layers:
-- **😎 Templates**: enable anyone to use data engines on all kind of subjects in minutes. -- **🏎 Drivers**: connectors to facilitate access to tools, and complex libraries (database, API, ML algorithm...) -- **🪐 Features**: production microservices on top of Jupyter like scheduling, asset sharing, notifications and more.
+All templates are readily accessible on [GitHub](https://github.com/jupyter-naas/awesome-notebooks) or via [Naas Search](https://naas.ai/search). -Naas Cloud is free to use with 100 credits/month.
-Open your account
+!https://site.naas.ai/assets/images/NaasSearch-1a3b28f814a61bfcbb1511997970a62d.gif -[>> More information](https://docs.naas.ai/) +## How is organized a template?[](https://site.naas.ai/docs/developers/templates#how-is-organized-a-template) +To ensure the quality of the templates, we have defined a framework. Each notebook shall be organized as follow. -## What is the objective of this repository ? +### Header[](https://site.naas.ai/docs/developers/templates#header)** -The objective of this repository is to create the largest catalog of production-ready Jupyter Notebooks templates. With those templates, it becomes easy to create data products (analytical dashboards, automation/AI engines and more). Check out the [data-product-template](https://github.com/jupyter-naas/data-product-template) repository to learn more.
-The repository is organized by source/tools for easy discovery. You can also use our ["Google-like" search](http://search.live.kn.naas.ai/) to find templates by keywords
- -To ensure the quality of the templates, we have defined a framework. Each notebook shall be organized with the following sections: - **Naas logo** - **# Title**: "Tool - Action of the notebook", as h1. An "Open in Naas" button will be added automatically by the CI/CD when a notebook is merged to the master branch. -- **Tags:**: hashtags relevant to the topics covered in the notebook, as text -- **Author:**: name and social profile link of the author(s), as text -- **Last update:** YYYY-MM-DD (Created: YYYY-MM-DD): The last update date refers to when the notebook was last edited, while the created date corresponds to when the notebook was initially merged. -- **Description:**: a one-liner explaining the benefits of the notebooks for the user, as text -- **References:**: list of references and websites utilized in the creation of this notebook +- **Tags:** hashtags relevant to the topics covered in the notebook, as text +- **Author:** name and social profile link of the author(s), as text +- **Last update:** YYYY-MM-DD (Created: YYYY-MM-DD): The last update date refers to when the notebook was last edited, while the created date corresponds to when the notebook was initially merged. +- **Description:** a one-liner explaining the benefits of the notebooks for the user, as text +- **References:** list of references and websites utilized in the creation of this notebook + +!https://site.naas.ai/assets/images/Templates_Header-891c53c6f58b031412f54f2c47f3bf6b.PNG + +### Outline[](https://site.naas.ai/docs/developers/templates#outline) + - **## Input**: list of all the variables, credentials, that needs to be setup, as h2 - **## Model**: list the functions applied to the data, as h2 - **## Output**: list the assets to be used by the user and its distribution channels if any, as h2 +!https://site.naas.ai/assets/images/Templates_Outline-60c612f83174a61f9bd9d3d912dccc2b.PNG -## How to contribute ? +## Providing Feedback[](https://site.naas.ai/docs/developers/templates#providing-feedback) -### Pre-requisites: -- Open free account on [Naas Cloud](https://www.naas.ai/free-forever) so we can test the templates in a similar environment -- Register to the [Contributor Program](https://form.typeform.com/to/jdls9qZf?typeform-source=www.naas.ai) so we can add you to team of contributors in the Naas GitHub organization -- Join our [Slack Community](https://join.slack.com/t/naas-club/shared_invite/zt-1970s5rie-dXXkigAdEJYc~LPdQIEaLA) so you can present yourself and #chat with us +At the top of the notebook, you'll find a link for providing feedback on the notebook you're using. This could be: -### Step by step process: +- A suggestion for a new feature that could enhance the notebook +- Documentation improvements to make it more user-friendly +- Notification of a typographical error +- A simple word of praise (🙂) -- **Step 1**: Find or propose an issue you want to work on - - The Backlog of the [Product Roadmap](https://github.com/orgs/jupyter-naas/projects/10) is where we put all the priorities - - The [Issues](https://github.com/jupyter-naas/awesome-notebooks/issues) section is where we gather all the needs -- **Step 2**: Prepare the issue before you start working on it - - Make sure the description is clear - - Tag yourself in Assignees section - - Change the status to 'In Progress' in Projects section/Community Roadmap - - Create a branch in Development section -- **Step 3**: Clone the awesome-notebooks repository on your Naas Cloud account and switch to the branch you created -- **Step 4**: Create folder named with the source tool (if it's not already created) -- **Step 5**: Copy/Paste template.ipynb at the root of the folder inside the folder you are working on, and start working on your notebook -- **Step 6**: Once you are happy with the result, commit to the branch by using Git extension or command line (make sure you use a GitHub personal access token and not password, otherwise it wont work) -- **Step 7**: Open a Pull Request and add a member of the core team as Reviewer ([Florent](https://github.com/FlorentLvr),[Maxime](https://github.com/Dr0p42) or [Jeremy](https://github.com/jravenel)) -- **Step 8**: Change status of this Issue to “Review” in Projects section and comment the Pull Request with a brief on what you have done -- **Step 9**: Expect a feedback and merge in the next 48h-72h -- **Step 10**: Once merged, promote your work on LinkedIn, Twitter and other social media channels! (Optional, but people need to know you are awesome 😉) +Upon clicking this link, you'll be redirected to a Google form where you can provide more information. We will endeavor to contact the notebook creator for improvements or seek community assistance during our bi-monthly community calls that aim to create new templates or enhance existing ones. -[>> More information](https://docs.naas.ai/contributing-to-naas) +!https://site.naas.ai/assets/images/Templates_GiveFeedback-0b6357200a2e2ffb4dfd6d4d451b2f57.PNG +## Reporting A Bug[](https://site.naas.ai/docs/developers/templates#reporting-a-bug) -## Support on social media -We are committed to sharing templates and giving shout outs to the contributors on our social media platforms, you can support us on: -- [Twitter](https://twitter.com/JupyterNaas) for fast updates
-- [LinkedIn](https://www.linkedin.com/company/naas-ai/) for more elaborated posts and articles
-- [Youtube](https://www.youtube.com/channel/UCKKG5hzjXXU_rRdHHWQ8JHQ/videos) for demos and tutorials
+Since all our templates are open-source, errors may occasionally occur. We apologize for any inconvenience that may cause and request your support in reporting these issues to help us rectify them. To report a bug, click on the link at the top of the notebook. You will be redirected to GitHub to create an issue. Please attach screenshots to help us understand the bug, and provide any other information that could assist us in reproducing the issue. We will strive to respond as quickly as possible to resolve the issue. + +!https://site.naas.ai/assets/images/Templates_BugReport-9005de95d2490678d263e65ed41b59e7.PNG + +## How to contribute?[](https://site.naas.ai/docs/developers/templates#how-to-contribute) + +### Pre-requisites[](https://site.naas.ai/docs/developers/templates#pre-requisites) + +- Open a [free account on Naas Cloud](https://app.naas.ai/) so we can test the templates in a similar environment. +- 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](https://github.com/orgs/jupyter-naas/teams/opensource-contributors). Please check your email and validate the invitation before you begin working on a new issue. +- Create your [GitHub personal access token](https://github.com/settings/tokens). 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[](https://site.naas.ai/docs/developers/templates#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[](https://site.naas.ai/docs/developers/templates#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. -# Template analytics +### Step 3: Work on Your Notebook[](https://site.naas.ai/docs/developers/templates#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[](https://site.naas.ai/docs/developers/templates#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 48-72 hours. + +### Step 5: Promote Your Work[](https://site.naas.ai/docs/developers/templates#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[](https://site.naas.ai/docs/developers/templates#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. + +# Support us on social media[](https://site.naas.ai/docs/developers/templates#support-us-on-social-media) + +We are committed to sharing templates and giving shout outs to the contributors on our social media platforms, you can support us on: -![Templates_monthly](https://public.naas.ai/bWV0cmljcy00MG5hYXMtMkVhaQ==/asset/09d0bd9ed8ac2479a2a4f05e60c74d101d140ffdfacd9b0ac7bbb4e53966.png) +- [Twitter](https://twitter.com/JupyterNaas) for fast updates +- [LinkedIn](https://www.linkedin.com/company/naas-ai/) for more elaborated posts and articles +- [Youtube](https://www.youtube.com/channel/UCKKG5hzjXXU_rRdHHWQ8JHQ/videos) for demos and tutorials # Templates list From 9f991555c9ed4221ed81fff72d5a549b5c999c4b Mon Sep 17 00:00:00 2001 From: FlorentLvr <48032461+FlorentLvr@users.noreply.github.com> Date: Thu, 5 Oct 2023 17:40:00 +0200 Subject: [PATCH 04/11] feat: update link --- README_template.md | 31 +++++++++++++++---------------- 1 file changed, 15 insertions(+), 16 deletions(-) diff --git a/README_template.md b/README_template.md index aa6a5586b0..93516d9ccb 100644 --- a/README_template.md +++ b/README_template.md @@ -8,13 +8,13 @@ Each of these templates adheres to a consistent framework, designed to expedite All templates are readily accessible on [GitHub](https://github.com/jupyter-naas/awesome-notebooks) or via [Naas Search](https://naas.ai/search). -!https://site.naas.ai/assets/images/NaasSearch-1a3b28f814a61bfcbb1511997970a62d.gif +https://site.naas.ai/assets/images/NaasSearch-1a3b28f814a61bfcbb1511997970a62d.gif -## How is organized a template?[](https://site.naas.ai/docs/developers/templates#how-is-organized-a-template) +## [How is organized a template?](https://site.naas.ai/docs/developers/templates#how-is-organized-a-template) To ensure the quality of the templates, we have defined a framework. Each notebook shall be organized as follow. -### Header[](https://site.naas.ai/docs/developers/templates#header)** +### [Header](https://site.naas.ai/docs/developers/templates#header)** - **Naas logo** - **# Title**: "Tool - Action of the notebook", as h1. An "Open in Naas" button will be added automatically by the CI/CD when a notebook is merged to the master branch. @@ -26,7 +26,7 @@ To ensure the quality of the templates, we have defined a framework. Each notebo !https://site.naas.ai/assets/images/Templates_Header-891c53c6f58b031412f54f2c47f3bf6b.PNG -### Outline[](https://site.naas.ai/docs/developers/templates#outline) +### [Outline](https://site.naas.ai/docs/developers/templates#outline) - **## Input**: list of all the variables, credentials, that needs to be setup, as h2 - **## Model**: list the functions applied to the data, as h2 @@ -34,7 +34,7 @@ To ensure the quality of the templates, we have defined a framework. Each notebo !https://site.naas.ai/assets/images/Templates_Outline-60c612f83174a61f9bd9d3d912dccc2b.PNG -## Providing Feedback[](https://site.naas.ai/docs/developers/templates#providing-feedback) +## [Providing Feedback](https://site.naas.ai/docs/developers/templates#providing-feedback) At the top of the notebook, you'll find a link for providing feedback on the notebook you're using. This could be: @@ -47,21 +47,20 @@ Upon clicking this link, you'll be redirected to a Google form where you can pro !https://site.naas.ai/assets/images/Templates_GiveFeedback-0b6357200a2e2ffb4dfd6d4d451b2f57.PNG -## Reporting A Bug[](https://site.naas.ai/docs/developers/templates#reporting-a-bug) +## [Reporting A Bug](https://site.naas.ai/docs/developers/templates#reporting-a-bug) Since all our templates are open-source, errors may occasionally occur. We apologize for any inconvenience that may cause and request your support in reporting these issues to help us rectify them. To report a bug, click on the link at the top of the notebook. You will be redirected to GitHub to create an issue. Please attach screenshots to help us understand the bug, and provide any other information that could assist us in reproducing the issue. We will strive to respond as quickly as possible to resolve the issue. !https://site.naas.ai/assets/images/Templates_BugReport-9005de95d2490678d263e65ed41b59e7.PNG -## How to contribute?[](https://site.naas.ai/docs/developers/templates#how-to-contribute) - -### Pre-requisites[](https://site.naas.ai/docs/developers/templates#pre-requisites) +## [How to contribute?](https://site.naas.ai/docs/developers/templates#how-to-contribute) +### [Pre-requisites](https://site.naas.ai/docs/developers/templates#pre-requisites) - Open a [free account on Naas Cloud](https://app.naas.ai/) so we can test the templates in a similar environment. - 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](https://github.com/orgs/jupyter-naas/teams/opensource-contributors). Please check your email and validate the invitation before you begin working on a new issue. - Create your [GitHub personal access token](https://github.com/settings/tokens). 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[](https://site.naas.ai/docs/developers/templates#step-1-create-or-select-an-issue) +### [Step 1: Create or Select an Issue](https://site.naas.ai/docs/developers/templates#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: @@ -70,14 +69,14 @@ Identify or propose an issue you wish to work on. It could be a snippet of Pytho - Change the status to 'In Progress' in the Projects section/Community Roadmap. - Create a branch in the Development section. -### Step 2: Technical Setup[](https://site.naas.ai/docs/developers/templates#step-2-technical-setup) +### [Step 2: Technical Setup](https://site.naas.ai/docs/developers/templates#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[](https://site.naas.ai/docs/developers/templates#step-3-work-on-your-notebook) +### [Step 3: Work on Your Notebook](https://site.naas.ai/docs/developers/templates#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. @@ -89,7 +88,7 @@ Start working on your notebook. Commit your work every time you make significant - 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[](https://site.naas.ai/docs/developers/templates#step-4-open-a-pull-request) +### [Step 4: Open a Pull Request](https://site.naas.ai/docs/developers/templates#step-4-open-a-pull-request) Open a Pull Request and add a core team member as Reviewer (Florent, Maxime, or Jeremy). @@ -97,19 +96,19 @@ Open a Pull Request and add a core team member as Reviewer (Florent, Maxime, or - 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 48-72 hours. -### Step 5: Promote Your Work[](https://site.naas.ai/docs/developers/templates#step-5-promote-your-work) +### [Step 5: Promote Your Work](https://site.naas.ai/docs/developers/templates#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[](https://site.naas.ai/docs/developers/templates#step-6-become-a-templates-maintainer) +### [Step 6: Become a Templates Maintainer](https://site.naas.ai/docs/developers/templates#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. -# Support us on social media[](https://site.naas.ai/docs/developers/templates#support-us-on-social-media) +# [Support us on social media](https://site.naas.ai/docs/developers/templates#support-us-on-social-media) We are committed to sharing templates and giving shout outs to the contributors on our social media platforms, you can support us on: From 8b19cea51e4b5d1b483cb05462e1f741952c0255 Mon Sep 17 00:00:00 2001 From: FlorentLvr <48032461+FlorentLvr@users.noreply.github.com> Date: Thu, 5 Oct 2023 17:41:41 +0200 Subject: [PATCH 05/11] feat: update image --- README_template.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/README_template.md b/README_template.md index 93516d9ccb..4dcec6e4a3 100644 --- a/README_template.md +++ b/README_template.md @@ -8,13 +8,13 @@ Each of these templates adheres to a consistent framework, designed to expedite All templates are readily accessible on [GitHub](https://github.com/jupyter-naas/awesome-notebooks) or via [Naas Search](https://naas.ai/search). -https://site.naas.ai/assets/images/NaasSearch-1a3b28f814a61bfcbb1511997970a62d.gif +![](https://site.naas.ai/assets/images/NaasSearch-1a3b28f814a61bfcbb1511997970a62d.gif) ## [How is organized a template?](https://site.naas.ai/docs/developers/templates#how-is-organized-a-template) To ensure the quality of the templates, we have defined a framework. Each notebook shall be organized as follow. -### [Header](https://site.naas.ai/docs/developers/templates#header)** +### [Header](https://site.naas.ai/docs/developers/templates#header) - **Naas logo** - **# Title**: "Tool - Action of the notebook", as h1. An "Open in Naas" button will be added automatically by the CI/CD when a notebook is merged to the master branch. @@ -24,7 +24,7 @@ To ensure the quality of the templates, we have defined a framework. Each notebo - **Description:** a one-liner explaining the benefits of the notebooks for the user, as text - **References:** list of references and websites utilized in the creation of this notebook -!https://site.naas.ai/assets/images/Templates_Header-891c53c6f58b031412f54f2c47f3bf6b.PNG +![](https://site.naas.ai/assets/images/Templates_Header-891c53c6f58b031412f54f2c47f3bf6b.PNG) ### [Outline](https://site.naas.ai/docs/developers/templates#outline) @@ -32,7 +32,7 @@ To ensure the quality of the templates, we have defined a framework. Each notebo - **## Model**: list the functions applied to the data, as h2 - **## Output**: list the assets to be used by the user and its distribution channels if any, as h2 -!https://site.naas.ai/assets/images/Templates_Outline-60c612f83174a61f9bd9d3d912dccc2b.PNG +![](https://site.naas.ai/assets/images/Templates_Outline-60c612f83174a61f9bd9d3d912dccc2b.PNG) ## [Providing Feedback](https://site.naas.ai/docs/developers/templates#providing-feedback) @@ -45,13 +45,13 @@ At the top of the notebook, you'll find a link for providing feedback on the not Upon clicking this link, you'll be redirected to a Google form where you can provide more information. We will endeavor to contact the notebook creator for improvements or seek community assistance during our bi-monthly community calls that aim to create new templates or enhance existing ones. -!https://site.naas.ai/assets/images/Templates_GiveFeedback-0b6357200a2e2ffb4dfd6d4d451b2f57.PNG +![](https://site.naas.ai/assets/images/Templates_GiveFeedback-0b6357200a2e2ffb4dfd6d4d451b2f57.PNG) ## [Reporting A Bug](https://site.naas.ai/docs/developers/templates#reporting-a-bug) Since all our templates are open-source, errors may occasionally occur. We apologize for any inconvenience that may cause and request your support in reporting these issues to help us rectify them. To report a bug, click on the link at the top of the notebook. You will be redirected to GitHub to create an issue. Please attach screenshots to help us understand the bug, and provide any other information that could assist us in reproducing the issue. We will strive to respond as quickly as possible to resolve the issue. -!https://site.naas.ai/assets/images/Templates_BugReport-9005de95d2490678d263e65ed41b59e7.PNG +![](https://site.naas.ai/assets/images/Templates_BugReport-9005de95d2490678d263e65ed41b59e7.PNG) ## [How to contribute?](https://site.naas.ai/docs/developers/templates#how-to-contribute) From 47b65c4c0cab66b68f9b36c6446c1d1df563a7d0 Mon Sep 17 00:00:00 2001 From: FlorentLvr <48032461+FlorentLvr@users.noreply.github.com> Date: Thu, 5 Oct 2023 17:58:38 +0200 Subject: [PATCH 06/11] feat: reorder pre requisite in README.md --- README_template.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README_template.md b/README_template.md index 4dcec6e4a3..781eac35b9 100644 --- a/README_template.md +++ b/README_template.md @@ -56,9 +56,9 @@ Since all our templates are open-source, errors may occasionally occur. We apolo ## [How to contribute?](https://site.naas.ai/docs/developers/templates#how-to-contribute) ### [Pre-requisites](https://site.naas.ai/docs/developers/templates#pre-requisites) -- Open a [free account on Naas Cloud](https://app.naas.ai/) so we can test the templates in a similar environment. -- 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](https://github.com/orgs/jupyter-naas/teams/opensource-contributors). Please check your email and validate the invitation before you begin working on a new issue. +- Register for the [Open Source Contributor Program](https://forms.gle/bfCBi8jRFFpapxNP6) 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](https://github.com/orgs/jupyter-naas/teams/opensource-contributors). Please check your email and validate the invitation before you begin working on a new issue. - Create your [GitHub personal access token](https://github.com/settings/tokens). 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. +- Open a [free account on Naas Cloud](https://app.naas.ai/) so we can test the templates in a similar environment. ### [Step 1: Create or Select an Issue](https://site.naas.ai/docs/developers/templates#step-1-create-or-select-an-issue) From 5b481b7447705615597e61db8b098bcb2451c966 Mon Sep 17 00:00:00 2001 From: FlorentLvr <48032461+FlorentLvr@users.noreply.github.com> Date: Thu, 5 Oct 2023 17:59:19 +0200 Subject: [PATCH 07/11] feat: align CONTRIBUTING.md with README.md --- CONTRIBUTING.md | 64 +++++++++++++++++++++++++++---------------------- 1 file changed, 35 insertions(+), 29 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 3b391dbea3..6489c7a742 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,48 +1,54 @@ -# How to contribute? -## Pre-requisites -- Create a free account on [Naas Cloud](http://app.naas.ai/) so we can test the templates in a similar environment and be on the same page. -- 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](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-personal-access-token-classic). 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 +## [How to contribute?](https://site.naas.ai/docs/developers/templates#how-to-contribute) + +### [Pre-requisites](https://site.naas.ai/docs/developers/templates#pre-requisites) +- Register for the [Open Source Contributor Program](https://forms.gle/bfCBi8jRFFpapxNP6) 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](https://github.com/orgs/jupyter-naas/teams/opensource-contributors). Please check your email and validate the invitation before you begin working on a new issue. +- Create your [GitHub personal access token](https://github.com/settings/tokens). 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. +- Open a [free account on Naas Cloud](https://app.naas.ai/) so we can test the templates in a similar environment. + +### [Step 1: Create or Select an Issue](https://site.naas.ai/docs/developers/templates#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. +- 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](https://site.naas.ai/docs/developers/templates#step-2-technical-setup) -## 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. +- 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](https://site.naas.ai/docs/developers/templates#step-3-work-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. +- 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](https://site.naas.ai/docs/developers/templates#step-4-open-a-pull-request) -## 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. +- 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 48-72 hours. + +### [Step 5: Promote Your Work](https://site.naas.ai/docs/developers/templates#step-5-promote-your-work) -## 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 +### [Step 6: Become a Templates Maintainer](https://site.naas.ai/docs/developers/templates#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. From b8db5ad53ddf9692534fccd668edfdf39a4c75ed Mon Sep 17 00:00:00 2001 From: FlorentLvr <48032461+FlorentLvr@users.noreply.github.com> Date: Thu, 5 Oct 2023 18:00:39 +0200 Subject: [PATCH 08/11] feat: update README_template.md title --- README_template.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README_template.md b/README_template.md index 781eac35b9..420f4d89e4 100644 --- a/README_template.md +++ b/README_template.md @@ -1,4 +1,5 @@ -# Naas Templates +# [Naas Templates](https://site.naas.ai/docs/developers/templates) [![Awesome](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)](https://github.com/sindresorhus/awesome) +(aka the "awesome-notebooks") ## About our templates From 9e3330cfca80c4ec51c9379e7ed49d294f376ff0 Mon Sep 17 00:00:00 2001 From: FlorentLvr <48032461+FlorentLvr@users.noreply.github.com> Date: Thu, 5 Oct 2023 18:02:55 +0200 Subject: [PATCH 09/11] feat: intro update README_template.md --- README_template.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/README_template.md b/README_template.md index 420f4d89e4..5449698843 100644 --- a/README_template.md +++ b/README_template.md @@ -1,9 +1,8 @@ # [Naas Templates](https://site.naas.ai/docs/developers/templates) [![Awesome](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)](https://github.com/sindresorhus/awesome) (aka the "awesome-notebooks") -## About our templates - -Our templates constitute the most extensive collection of open-source notebooks currently available. They encompass a wide range of tools, technologies, and libraries, featuring snippets of notebooks, notebooks for automation and analytics, and others that harness the power of AI. +## What is the objective of this repository ? +The objective of this repository is to create the largest catalog of production-ready Jupyter Notebooks templates. With those templates, it becomes easy to create data products (analytical dashboards, automation/AI engines and more). Each of these templates adheres to a consistent framework, designed to expedite your coding process. While these templates are designed for ease of use, some may require data science skills for setup, particularly those that interface with third-party tools via API. These templates can function independently, but they also serve as integral components of data products. Consider them as the essential parts needed to assemble your 'car engine'. By developing these templates and ensuring their standalone functionality, we streamline the process of data product development, as we already comprehend the operation of some parts within it. From c0aa2ed0a4629baedd51ab00a0475fdc90a1bf3e Mon Sep 17 00:00:00 2001 From: FlorentLvr <48032461+FlorentLvr@users.noreply.github.com> Date: Thu, 5 Oct 2023 18:33:44 +0200 Subject: [PATCH 10/11] feat: review with jrv Update README_template.md --- README_template.md | 38 ++++++++++++++++++++------------------ 1 file changed, 20 insertions(+), 18 deletions(-) diff --git a/README_template.md b/README_template.md index 5449698843..58e599f7f1 100644 --- a/README_template.md +++ b/README_template.md @@ -1,4 +1,4 @@ -# [Naas Templates](https://site.naas.ai/docs/developers/templates) [![Awesome](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)](https://github.com/sindresorhus/awesome) +# Naas Templates[![Awesome](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)](https://github.com/sindresorhus/awesome) (aka the "awesome-notebooks") ## What is the objective of this repository ? @@ -10,11 +10,11 @@ All templates are readily accessible on [GitHub](https://github.com/jupyter-naa ![](https://site.naas.ai/assets/images/NaasSearch-1a3b28f814a61bfcbb1511997970a62d.gif) -## [How is organized a template?](https://site.naas.ai/docs/developers/templates#how-is-organized-a-template) +## How is organized a template? To ensure the quality of the templates, we have defined a framework. Each notebook shall be organized as follow. -### [Header](https://site.naas.ai/docs/developers/templates#header) +### Header - **Naas logo** - **# Title**: "Tool - Action of the notebook", as h1. An "Open in Naas" button will be added automatically by the CI/CD when a notebook is merged to the master branch. @@ -26,7 +26,7 @@ To ensure the quality of the templates, we have defined a framework. Each notebo ![](https://site.naas.ai/assets/images/Templates_Header-891c53c6f58b031412f54f2c47f3bf6b.PNG) -### [Outline](https://site.naas.ai/docs/developers/templates#outline) +### Outline - **## Input**: list of all the variables, credentials, that needs to be setup, as h2 - **## Model**: list the functions applied to the data, as h2 @@ -34,7 +34,7 @@ To ensure the quality of the templates, we have defined a framework. Each notebo ![](https://site.naas.ai/assets/images/Templates_Outline-60c612f83174a61f9bd9d3d912dccc2b.PNG) -## [Providing Feedback](https://site.naas.ai/docs/developers/templates#providing-feedback) +## Providing Feedback At the top of the notebook, you'll find a link for providing feedback on the notebook you're using. This could be: @@ -47,20 +47,20 @@ Upon clicking this link, you'll be redirected to a Google form where you can pro ![](https://site.naas.ai/assets/images/Templates_GiveFeedback-0b6357200a2e2ffb4dfd6d4d451b2f57.PNG) -## [Reporting A Bug](https://site.naas.ai/docs/developers/templates#reporting-a-bug) +## Reporting A Bug Since all our templates are open-source, errors may occasionally occur. We apologize for any inconvenience that may cause and request your support in reporting these issues to help us rectify them. To report a bug, click on the link at the top of the notebook. You will be redirected to GitHub to create an issue. Please attach screenshots to help us understand the bug, and provide any other information that could assist us in reproducing the issue. We will strive to respond as quickly as possible to resolve the issue. ![](https://site.naas.ai/assets/images/Templates_BugReport-9005de95d2490678d263e65ed41b59e7.PNG) -## [How to contribute?](https://site.naas.ai/docs/developers/templates#how-to-contribute) +## How to contribute? -### [Pre-requisites](https://site.naas.ai/docs/developers/templates#pre-requisites) +### Pre-requisites - Register for the [Open Source Contributor Program](https://forms.gle/bfCBi8jRFFpapxNP6) 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](https://github.com/orgs/jupyter-naas/teams/opensource-contributors). Please check your email and validate the invitation before you begin working on a new issue. - Create your [GitHub personal access token](https://github.com/settings/tokens). 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. -- Open a [free account on Naas Cloud](https://app.naas.ai/) so we can test the templates in a similar environment. +- Open a [free account on Naas Lab](https://app.naas.ai/) so we can test the templates in a similar environment. -### [Step 1: Create or Select an Issue](https://site.naas.ai/docs/developers/templates#step-1-create-or-select-an-issue) +### 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: @@ -69,16 +69,18 @@ Identify or propose an issue you wish to work on. It could be a snippet of Pytho - Change the status to 'In Progress' in the Projects section/Community Roadmap. - Create a branch in the Development section. -### [Step 2: Technical Setup](https://site.naas.ai/docs/developers/templates#step-2-technical-setup) +### Step 2: Technical Setup Clone the awesome-notebooks repository on your Naas Cloud account and switch to the branch you created. +If a draft of a template (generated with our AI system) has been already created, you can directly start working on it. +Otherwise, you kick start manually: - 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. +- Copy and paste template.ipynb at the root of the repository and start working on your notebook. -### [Step 3: Work on Your Notebook](https://site.naas.ai/docs/developers/templates#step-3-work-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. +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: @@ -88,7 +90,7 @@ Start working on your notebook. Commit your work every time you make significant - 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](https://site.naas.ai/docs/developers/templates#step-4-open-a-pull-request) +### Step 4: Open a Pull Request Open a Pull Request and add a core team member as Reviewer (Florent, Maxime, or Jeremy). @@ -96,19 +98,19 @@ Open a Pull Request and add a core team member as Reviewer (Florent, Maxime, or - 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 48-72 hours. -### [Step 5: Promote Your Work](https://site.naas.ai/docs/developers/templates#step-5-promote-your-work) +### 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](https://site.naas.ai/docs/developers/templates#step-6-become-a-templates-maintainer) +### 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. -# [Support us on social media](https://site.naas.ai/docs/developers/templates#support-us-on-social-media) +## Support us on social media We are committed to sharing templates and giving shout outs to the contributors on our social media platforms, you can support us on: From 962b87aca0bc87c933597e465ba0f4bbde0aa639 Mon Sep 17 00:00:00 2001 From: FlorentLvr <48032461+FlorentLvr@users.noreply.github.com> Date: Thu, 5 Oct 2023 18:34:11 +0200 Subject: [PATCH 11/11] feat: Update CONTRIBUTING.md review jrv --- CONTRIBUTING.md | 24 +++++++++++++----------- 1 file changed, 13 insertions(+), 11 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 6489c7a742..0f826560a1 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,11 +1,11 @@ -## [How to contribute?](https://site.naas.ai/docs/developers/templates#how-to-contribute) +## How to contribute? -### [Pre-requisites](https://site.naas.ai/docs/developers/templates#pre-requisites) +### Pre-requisites - Register for the [Open Source Contributor Program](https://forms.gle/bfCBi8jRFFpapxNP6) 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](https://github.com/orgs/jupyter-naas/teams/opensource-contributors). Please check your email and validate the invitation before you begin working on a new issue. - Create your [GitHub personal access token](https://github.com/settings/tokens). 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. -- Open a [free account on Naas Cloud](https://app.naas.ai/) so we can test the templates in a similar environment. +- Open a [free account on Naas Lab](https://app.naas.ai/) so we can test the templates in a similar environment. -### [Step 1: Create or Select an Issue](https://site.naas.ai/docs/developers/templates#step-1-create-or-select-an-issue) +### 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: @@ -14,16 +14,18 @@ Identify or propose an issue you wish to work on. It could be a snippet of Pytho - Change the status to 'In Progress' in the Projects section/Community Roadmap. - Create a branch in the Development section. -### [Step 2: Technical Setup](https://site.naas.ai/docs/developers/templates#step-2-technical-setup) +### Step 2: Technical Setup Clone the awesome-notebooks repository on your Naas Cloud account and switch to the branch you created. +If a draft of a template (generated with our AI system) has been already created, you can directly start working on it. +Otherwise, you kick start manually: - 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. +- Copy and paste template.ipynb at the root of the repository and start working on your notebook. -### [Step 3: Work on Your Notebook](https://site.naas.ai/docs/developers/templates#step-3-work-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. +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: @@ -33,7 +35,7 @@ Start working on your notebook. Commit your work every time you make significant - 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](https://site.naas.ai/docs/developers/templates#step-4-open-a-pull-request) +### Step 4: Open a Pull Request Open a Pull Request and add a core team member as Reviewer (Florent, Maxime, or Jeremy). @@ -41,13 +43,13 @@ Open a Pull Request and add a core team member as Reviewer (Florent, Maxime, or - 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 48-72 hours. -### [Step 5: Promote Your Work](https://site.naas.ai/docs/developers/templates#step-5-promote-your-work) +### 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](https://site.naas.ai/docs/developers/templates#step-6-become-a-templates-maintainer) +### 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.