Merge branch '2-document-how-to-create-a-new-drupalsite-with-extra-composer-modules' into 'master'

Add docs for site creation with extra config repo

Closes #2

See merge request !2

docs/create_site.md

@@ -77,16 +77,13 @@ Environment allows you to define alternative instances of the website with diffe
 Version refers to the version and release of the CERN Drupal Distribution that will be deployed to serve this website. Changing this value triggers the website's update process.
 
 * **Name**: Select the desired version of the branch of CERN Drupal Distribution.
-* **Release Spec**: Specify the desired release version. The available releases are:
-    - `RELEASE-2021.06.16T08-09-55Z`
-    - `RELEASE-2021.06.07T21-48-18Z`
-    - `RELEASE-2021.06.01T15-27-02Z`
+* **Release Spec**: Specify the release version. The available release is: `RELEASE-2021.06.16T08-09-55Z`.
 
 ![Screenshot](images/openshift_console-create_drupalsite_version_fill.png)
 
 ---
 
-#### 8. Click on `Create` button
+#### 9. Click on `Create` button
 
 ![Screenshot](images/openshift_console-create_button.png)
 

docs/create_site_extra_composer_modules.md

+<div data-theme-toc="true"> </div>
+
+# Creating a drupal site with extra drupal modules
+
+You can create a drupal site with extra drupal modules by following a few simple steps. 
+
+For adding extra drupal modules to your site, you'll need to use:
+- [Composer](https://getcomposer.org/): A tool for managing dependencies in PHP.
+- A [GitLab repository](https://gitlab.cern.ch/help/user/project/repository/index.md): A place to store your code and change it with version control.
+
+Note that this is the recommended workflow for adding drupal modules to your website, because you can fetch dependencies automatically and keep the website versioned.
+This functionality will eventually be expanded to include site configuration as well. If you would like to add drupal modules without composer or git, please read [WebDAV file access]() guide. (available soon)
+
+#### 1. Create a repository with `composer.json`
+
+Every module that you want to install has to be included as a composer dependency. This can be done in two ways:
+- by adding manually the right line in [composer.json](https://gitlab.cern.ch/drupal/paas/example-drupalsite-d8-extraconfig/-/blob/master/composer.json) under `require`.
+- by running `composer require <module>`.
+
+Afer, you need to create a repository and add the `composer.json` file, e.g. https://gitlab.cern.ch/drupal/paas/example-drupalsite-d8-extraconfig.git.
+
+#### 2. Follow the [Creating a drupal site](https://drupal-community.web.cern.ch/t/creating-a-drupal-site/1121) guide till [Step 7](https://drupal-community.web.cern.ch/t/creating-a-drupal-site/1121#7-click-on-environment-to-expand-the-options-panel-with-the-default-settings-9)
+
+#### 3. Fill the `Extra configs repo` field
+
+![Screenshot](images/openshift_console-create_drupalsite_extraconfig_repo.png)
+
+---
+
+#### 4. Continue with [Step 8](https://drupal-community.web.cern.ch/t/creating-a-drupal-site/1121#8-click-on-version-to-expand-the-options-panel-with-the-default-settings-10) and [Step 9](https://drupal-community.web.cern.ch/t/creating-a-drupal-site/1121#9-click-on-create-button-11) of the [Creating a drupal site](https://drupal-community.web.cern.ch/t/creating-a-drupal-site/1121) guide
+
+Your drupal site is ready.