[Platform.sh] Inline document support for GraphQL

.gitignore

@@ -19,6 +19,7 @@
 
 /.web-server-pid
 /app/config/parameters.yml
+/app/config/graphql/*
 /build/
 /phpunit.xml
 /var/*

.platform.app.yaml

@@ -73,6 +73,10 @@ mounts:
     'web/var':
         source: local
         source_path: var
+    # GraphQL Schemas need be generated dynamically on server to reflect live repository status
+    #'app/config/graphql':
+    #    source: local
+    #    source_path: graphql
     # To be prepared to move to cluster, please rather use e.g. persisted Redis instance.
     'web/sessions':
         source: local
@@ -121,6 +125,9 @@ hooks:
         # Example of additional deploy hooks if you use doctrine and/or kaliop migration bundle
         ##bin/console doctrine:migrations:migrate --no-interaction --allow-no-migration
         ##bin/console kaliop:migration:migrate --no-interaction --no-debug
+
+        ## Deploy hook to automatically generate GraphQL schema on deploy (could also be executed manually when needed)
+        # php bin/console ezplatform:graphql:generate-schema
 
     # Post deploy hook, like deploy but after being deployed and live, for deploy tasks we can do asynchronously
     #post_deploy: |

app/config/graphql/README.md

@@ -0,0 +1,8 @@
+This directory is intentionally left empty. It is to be populated by automatically generated GraphQL schema configuration files. Schema generation is done with the following commands:
+
+```
+php bin/console ezplatform:graphql:generate-schema
+php bin/console cache:clear
+```
+
+For more information on eZ Platform and GraphQL see: https://doc.ezplatform.com/en/latest/api/graphql/#toc