Reverse proxy gotchas and directive clarifications

v2:-Documentation.md

@@ -771,6 +771,7 @@ transport http {
 	keepalive_idle_conns <max_count>
 }
 ```
+When defining a `tls` directive in the scope of a `transport` object nested inside a `reverse_proxy` object, make sure the upstreams are configured for HTTPS traffic or else you will get a `TLS handshake` error.
 
 FastCGI transport options:
 
@@ -791,6 +792,7 @@ Issue an HTTP redirect.
 ```
 redir [<matcher>] to [<code>|permanent|temporary]
 ```
+May cause infinite redirection loops (`Secure Connection Failed`) so be wary of carelessly defining `redir` directives
 
 ##### rewrite