minor docs fixes

Author: oxyc

docs/configurations/webservers-nginx.md

@@ -40,17 +40,17 @@ If you are using Ubuntu as your base OS and you want to get started quickly with
         ssl_ciphers         HIGH:!aNULL:!MD5;
 ```
 
-### Customizing server block configuration
+## Customizing server block configuration
 
 If you can't customize via variables because an option isn't exposed, you can override the template used to generate the the virtualhost configuration file.
 
 ```yaml
 nginx_vhost_template: "{{ config_dir }}/templates/nginx-vhost.conf.j2"
 ```
 
-You can either copy and modify the provided `nginx-vhost.conf.j2` template, or extend it and and override the specific template block you need to change.
+You can either copy and modify the provided `nginx-vhost.conf.j2` template, or extend it and override the specific template block you need to change.
 
-_If you extend Drupal VM's provided base template, the path referenced should to be relative to the playbook.yml._
+_If you extend Drupal VM's provided base template, the path referenced should to be relative to playbook.yml._
 
 ```
 {% extends 'templates/nginx-vhost.conf.j2' %}

docs/extras/drush.md

@@ -41,7 +41,7 @@ If you want to customize the generated alias file you can override the `drush_al
 drush_aliases_host_template: "{{ config_dir }}/templates/drupalvm.aliases.drushrc.php.j2"
 ```
 
-Eg. to only print the alias for your main domain, and not the subdomain you can override the file using a child template.
+Eg. to only print the alias for your main domain, and not the subdomain you can override the file using a [Jinja2 child template](http://jinja.pocoo.org/docs/2.9/templates/#child-template).
 
 ```php
 {% extends 'templates/drupalvm.aliases.drushrc.php.j2' %}

docs/extras/varnish.md

@@ -31,15 +31,17 @@ $settings['reverse_proxy_addresses'] = array('127.0.0.1');
 
 If you don't set these values, Drupal will think all requests are coming from `127.0.0.1`. There are other settings you can change to make Drupal not store copies of cached pages in the Database (since Varnish is caching everything, this is redundant), but those other settings are not covered here.
 
-### Extending the base `drupalvm.vcl.j2` template
+## Extending the base `drupalvm.vcl.j2` template
 
-If you can't customize via variables because an option isn't exposed, you can extend the base `drupalvm.vcl.j2` through Jinja2 template inheritance.
+If you can't customize via variables because an option isn't exposed, you can extend the base `drupalvm.vcl.j2` through [Jinja2 template inheritance](http://jinja.pocoo.org/docs/2.9/templates/#template-inheritance).
 
 ```yaml
 varnish_default_vcl_template_path: "{{ config_dir }}/templates/drupalvm.vcl.j2"
 ```
 
-_If you extend Drupal VM's provided base template, the path referenced should to be relative to the playbook.yml._
+Either copy the `drupalvm.vcl.j2` and modify it to your liking, or extend it and override the blocks you need to adjust.
+
+_If you extend Drupal VM's provided base template, the path referenced should to be relative to playbook.yml._
 
 ```
 {% extends 'templates/drupalvm.vcl.j2' %}
@@ -57,6 +59,6 @@ unset resp.http.Purge-Cache-Tags;
 {% endblock %}
 ```
 
-The `{{ super() }}` Jinja2 function returns the original block content from the base template.
+The [`{{ super() }}` Jinja2 function](http://jinja.pocoo.org/docs/2.9/templates/#super-blocks) returns the original block content from the base template.
 
 For a list of available role variables, see the [`geerlingguy.varnish` Ansible role's README](https://github.com/geerlingguy/ansible-role-varnish#readme).