Merge pull request #42 from viglesiasce/reorg

Create stable and incubator directories

CONTRIBUTING.md

@@ -22,9 +22,10 @@ This repository is used by Chart developers for maintaining the official charts
 ### How to contribute a Chart
 
 1. If you haven't already done so, sign a Contributor License Agreement (see details above).
-2. Fork this repository, develop and test your Chart.
-3. Ensure your Chart follows the technical and documentation guidelines, described below.
-4. Submit a pull request.
+1. Fork this repository, develop and test your Chart.
+1. Choose the correct folder for your chart based on the information in the [Repository Structure](#repository-structure) section
+1. Ensure your Chart follows the [technical](#technical-requirements) and [documentation](#documentation-requirements) guidelines, described below.
+1. Submit a pull request.
 
 #### Technical requirements
 
@@ -36,7 +37,6 @@ This repository is used by Chart developers for maintaining the official charts
 * Must include source GitHub repositories for images used in the Chart
 * Images should not have any major security vulnerabilities
 * Must be up-to-date with the latest stable Helm/Kubernetes features
-    * Don't use alpha Kubernetes features
     * Use Deployments in favor of ReplicationControllers
 * Should follow Kubernetes best practices
     * Include Health Checks wherever practical

README.md

@@ -19,6 +19,22 @@ The Charts in the master branch of this repository match the latest packaged Cha
 
 The purpose of this repository is to provide a place for maintaining and contributing official Charts, with CI processes in place for managing the releasing of Charts into the Chart Repository.
 
+The Charts in this repository are organized into two folders:
+* stable
+* incubator
+
+Stable Charts:
+
+1. Provide a method for data persistence (if applicable)
+1. Support application upgrades
+1. Allow customization of the application configuration
+1. Provide a secure default configuration
+1. Do not leverage alpha features of Kubernetes
+
+Incubator Charts are those that do not meet these criteria, but still meet the technical and documentation requirements described in CONTRIBUTING.md. Having the incubator folder allows charts to be shared and improved on until they are ready to be moved into the stable folder.
+
+In order to get a Chart from incubator to stable, Chart maintainers should open a pull request that moves the chart folder.
+
 ## Contributing a Chart
 
 We'd love for you to contribute a Chart that provides a useful application or service for Kubernetes. Please read our [Contribution Guide](CONTRIBUTING.md) for more information on how you can contribute Charts.