Merge "Add introductions to the chapters"

doc/source/code-and-documentation/index.rst

@@ -6,7 +6,7 @@ Code & Documentation Contributor Guide
    :caption: Code and Documentation Contributors
    :maxdepth: 2
 
-   /common/introduction
+   /code-and-documentation/introduction
    /common/irc
    /common/communication
    /common/accounts

doc/source/code-and-documentation/introduction.rst

@@ -0,0 +1,17 @@
+############
+Introduction
+############
+
+The heart of open source is the people who are participating in a community and
+it is no different in case of OpenStack either.
+
+This chapter will guide you through of all the tools and processes that we are
+using to develop, test, maintain, and document the projects in OpenStack.
+
+Communication is underrated, but crucial when it comes to participating in an
+open source community. We have several tools that we use for online and offline
+communication, which we encourage you to use.
+
+We do not differentiate between the different types of contributions such as
+code or documentation therefore you will find guidance in this chapter for all
+types.

doc/source/index.rst

@@ -10,6 +10,7 @@ The OpenStack Contributor Guide
 .. toctree::
    :maxdepth: 1
 
+   common/introduction
    code-and-documentation/index
    users/index
    operators/index

doc/source/operators/index.rst

@@ -6,6 +6,7 @@ Operators' Contributor Guide
    :caption: Operator Contributors
    :maxdepth: 2
 
+   /operators/introduction
    /common/introduction
    /common/irc
    /common/accounts

doc/source/operators/introduction.rst

@@ -0,0 +1,13 @@
+############
+Introduction
+############
+
+OpenStack is running in production all around the globe resulting in a large
+group of people who's daily job is to deploy and operate the platform.
+
+We actively encourage operators to participate and engage with the community to
+provide feedback and help us shape the software and documentation to be more
+user friendly.
+
+To find documentation on how to deploy and run OpenStack you can look up the
+`OpenStack Manuals <https://docs.openstack.org/>`_ web page.

doc/source/users/index.rst

@@ -6,6 +6,7 @@ Users' Contributor Guide
    :caption: User Contributors
    :maxdepth: 2
 
+   /users/introduction
    /common/irc
    /common/accounts
    /common/communication

doc/source/users/introduction.rst

@@ -0,0 +1,13 @@
+############
+Introduction
+############
+
+
+OpenStack is running in production all around the globe addressing use cases
+from all parts of the industry.
+
+We actively encourage operators to participate and engage with the community to
+share feedback and views on emerging use cases and requirements to address.
+
+To find documentation on how to deploy and run OpenStack you can look up the
+`OpenStack Manuals <https://docs.openstack.org/>`_ web page.