Aug 2, 2023 · Aug 1, 2023 · Aug 2, 2023 · Aug 1, 2023 · Aug 1, 2023
diff --git a/README.md b/README.md
diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md
Original file line number	Diff line number	Diff line change
Expand Up		@@ -8,12 +8,16 @@ This repository contains executable Python notebooks, sample apps, and resources

		# Python notebooks 📒

	The [`notebooks` folder](notebooks/README.md) contains a range of executable Python notebooks, so you can test these features out for yourself. Colab provides an easy-to-use Python virtual environment in the browser.
	The [`notebooks`](notebooks/README.md) folder contains a range of executable Python notebooks, so you can test these features out for yourself. Colab provides an easy-to-use Python virtual environment in the browser.

		# Example apps 💻

		The [`example-apps`](example-apps/README.md) folder contains example apps that demonstrate Elasticsearch for a number of use cases, using different programming languages and frameworks.

	# Contributing 🎁

	See [contributing guidelines](docs/CONTRIBUTING.md).

		# Support 🛟

		Learn how to [get Support](docs/SUPPORT.md).
Expand Down
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,68 @@
	# Contributing

	If you would like to contribute new example apps to the `elasticsearch-labs` repo, we would love to hear from you!

	## Before you start

	Prior to opening a pull request, please:
	- Create an issue to [discuss the scope of your proposal](https://github.com/elastic/elasticsearch-labs/issues). We are happy to provide guidance to make for a pleasant contribution experience.
	- Sign the [Contributor License Agreement](https://www.elastic.co/contributor-agreement/). We are not asking you to assign copyright to us, but to give us the right to distribute your code without restriction. We ask this of all contributors in order to assure our users of the origin and continuing existence of the code. You only need to sign the CLA once.

	## Contributing to Python notebooks 📒

	### Why
Copy link Contributor Author @demjened demjened Aug 1, 2023 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others. Learn more. I went with the 5W1H method to break down the list of bulletpoints into more concise chunks.

	* The main goal of this repo is to help people learn about solving various problems with the Elastic Stack using step-by-step interactive guides and specific applications.
	* Remember your target audience: developers who want to try out some technology with Elastic. They may not be familiar with all the technologies.

	### Where

	* Select a folder under [notebooks](../notebooks/README.md) that matches the category of your notebook. If none of them match, create a new folder.
	* Create a folder under the category for your notebook.
demjened marked this conversation as resolved. Outdated Show resolved Hide resolved

	### What

	* Add your `.ipynb` file to the folder.
	* The notebook should be self-contained. Avoid cross-linking code, data files, configuration etc. from other folders.
	* We prefer the `kebab-case` file naming convention.
	* Please write simple code and concise documentation, where appropriate.
	* Start with a text cell that summarizes what the notebook will demonstrate. Feel free to use images - sometimes a picture is worth a thousand words.
	* Add a header and description section before each code cell. Explain in simple terms what the code will be doing and what the expected outcome is.
	* When the output of a cell is relevant, preserve it in the notebook.

	### How

	* We recommend building the notebook in an interactive environment, such as [Google Colab](https://colab.google/). This way you can test all the steps and capture the output.
	* Never leave any secrets in the code (API keys, passwords etc). Also avoid hardcoding URLs and IDs that may change from user to user. Instead use environment variables that need to be set by the user while they are running the notebook.
	* Test your notebook end to end before submitting a pull request.
	* Example of a well-formed notebook: [question-answering.ipynb](../notebooks/generative-ai/question-answering.ipynb).

	## Contributing to example applications 💻

	### Why

	* The main goal of this repo is to help people learn about solving various problems with the Elastic Stack using step-by-step interactive guides and specific applications.
	* Remember your target audience: developers who want to try out some technology with Elastic. They may not be familiar with all the technologies.

	### Where

	* Select a folder under [example-apps](../example-apps/README.md) that matches the category of your applications. If none of them match, create a new folder.
	* Create a folder under the category for your applications.

	### What

	* Add your app's files to the folder.
	* The app should be self-contained. Avoid cross-linking code, data files, configuration etc. from other folders.
	* Please write simple code and concise documentation, where appropriate.
	* Add a `README.md` file in the root folder of the app:
	* Summarize what the app will demonstrate. Feel free to use images - sometimes a picture is worth a thousand words.
	* List language requirements in the readme file, e.g. "Python 3.6+".
	* List clear instructions for installing and runing the example app in the readme file. This includes
	* Upload sample data files as necessary, or instructions for downloading them from an external source. Consider the license for any datasets.
	* Mention the version of the Elastic Stack that the example was tested with.

	### How

	* Never leave any secrets in the code (API keys, passwords etc). Also avoid hardcoding URLs and IDs that may change from user to user. Instead use environment variables that need to be set by the user while they are running the app.
	* Test your app end to end before submitting a pull request.
	* Example of a well-formed app: [OpenAI-Py](../example-apps/OpenAI-embeddings/OpenAI-Py/README.md).