Docs: Deployer 7 Updates

docs/config.md

@@ -1 +1,41 @@
 # Config
+
+In the `config:` section of your `yaml` file you set all the required items to start deploying your application.  It starts with `config:` following by the items in configuration in an indented list. Example
+
+```yml
+config:
+  application: 'domain'
+```
+
+All the options for configuration will be discussed below.
+
+## Application
+
+the name of your application is the first item to start with. The domain name of the application is a standard choice:
+
+```yml
+application: 'domain'
+```
+
+## Respository
+
+Using `repository` you can set the repository you would like to use for deployment. Example:
+
+```yml
+repository: 'git@github.com:user/domain.git'
+```
+
+
+## Releases
+
+How many releases to keep can be set with `keep_releases`:
+
+```yml
+keep_releases: 10
+```
+
+## Shared Files
+
+```
+shared_files: 
+```

docs/contrib/php-fpm.md

@@ -24,18 +24,14 @@ require 'contrib/php-fpm.php';
 ## Usage
 
 Start by explicitely providing the current version of PHP-version using the `php_fpm_version`.
-Alternatively, you may use any of the options above to configure how PHP-fpm should reload.
 
-Then, add the `php-fpm:reload` task at the end of your deployments by using the `after` method like so.
+To set the appropriate PHP FPM version you add a line starting with `php_fpm_version` followed by the version needed to your `.yaml` file. Example:
 
-```php
-set('php_fpm_version', '8.0');
-after('deploy', 'php-fpm:reload');
+```yml
+php_fpm_version: 7.4
 ```
 
 
-
-
 ## Configuration
 ### php_fpm_version
 [Source](https://github.com/deployphp/deployer/blob/master/contrib/php-fpm.php#L32)

docs/recipe/deploy/writable.md

@@ -43,7 +43,7 @@ One of:
 - acl
 
 ```php title="Default value"
-'chgrp'
+'acl'
 ```
 
 

docs/yaml-examples/laravel-yaml.md

@@ -0,0 +1,65 @@
+# Laravel PHP Yaml Example
+
+Here is an example `yaml` file for a Laravel PHP setup using the Laravel recipe `recipes/laravel.php` as well as PHP FPM & NPM from the `contrib` directory. The repository is a dummy one in this example, but all else is useful for most Laravel setups:
+
+```yml
+import:
+  - recipe/laravel.php
+  - contrib/php-fpm.php
+  - contrib/npm.php
+
+config:
+  application: 'domain'
+  repository: 'git@github.com:user/domain.git'
+  php_fpm_version: 7.4
+  keep_releases: 10
+  shared_files: 
+    - '.env'
+    - '.transip_private_key'
+  shared_dirs:
+    - 'public/uploads'
+    - 'public/published'
+    - 'storage/logs'
+    - 'storage/tls'
+    - 'storage/app/public'
+    - 'storage/app/modules'
+  writable_dirs:
+    - 'public/uploads'
+    - 'public/published'
+    - 'storage/framework/cache/data'
+    - 'storage/logs'
+    - 'storage/tls'
+    - 'storage/app/public'
+    - 'storage/app/modules'
+
+hosts:
+  prod:
+    remote_user: forge
+    hostname: 'domain.com'
+    deploy_path: '~/{{hostname}}'
+  staging:
+    remote_user: forge
+    hostname: 'staging.domain.com'
+    deploy_path: '~/{{hostname}}'
+
+tasks:
+  deploy:
+    - deploy:prepare
+    - deploy:vendors
+    - artisan:storage:link
+    - artisan:view:cache
+    - artisan:config:cache
+    - artisan:migrate
+    - npm:install
+    - npm:run:prod
+    - deploy:publish
+    - php-fpm:reload
+  npm:run:prod:
+    script:
+      - 'cd {{release_or_current_path}} && npm run prod'
+
+after:
+  deploy:
+    - failed:deploy:unlock
+    - artisan:horizon:terminate
+```

docs/yaml.md

@@ -1,3 +1,31 @@
 # YAML 
 
 TODO
+
+
+## General Example
+
+Here is a general yaml example for your average PHP application:
+
+``yml
+import:
+  - 
+
+config:
+  application: 'domain'
+  repository: 'git@github.com:user/domain.git'
+  php_fpm_version: 7.4
+  keep_releases: 10
+  shared_files: 
+    - 
+  shared_dirs:
+    - 
+  writable_dirs:
+    - 
+```
+
+
+## Specific Examples
+
+[Laravel PHP Framework Example](yaml-examples/laravel-yaml.md)
+