Add a "Tips" section. Contributions welcome.

R1/source/_templates/phkbar.html

@@ -22,15 +22,22 @@
 	<a href="/security/index.html">Security & Advisories</a>
     </li>	
     <li class="toctree-l1"><a href="/docs/index.html">Documentation</a></li>	
-    <li class="toctree-l2"><a href="/docs/trunk">- trunk(5.0) </a></li>	
-    <li class="toctree-l2"><a href="/docs/4.1">- 4.1.x</a></li>	
-    <li class="toctree-l2"><a href="/docs/4.0">- 4.0.x</a></li>	
+    <li class="toctree-l2">
+	<a href="/docs/trunk">trunk(5.0)</a>
+        | <a href="/docs/4.1">4.1</a>
+        | <a href="/docs/4.0">4.0</a>
+    </li>	
     <li class="toctree-l1"><a href="https://www.varnish-software.com/book/">Varnish Book (PDF)</a></li>	
-    <li class="toctree-l2"><a href="http://book.varnish-software.com/4.0/">- 4.x</a></li>
-    <li class="toctree-l2"><a href="http://book.varnish-software.com/3.0/">- 3.x</a></li>
+    <li class="toctree-l2">
+	<a href="http://book.varnish-software.com/4.0/">4.0</a>
+        | <a href="http://book.varnish-software.com/3.0/">3.0</a>
+    </li>
     <li class="toctree-l1">
 	<a href="https://github.com/varnishcache/varnish-cache">Source/Bugs/Patches</a>
     </li>	
+    <li class="toctree-l1">
+	<a href="/tips/index.html">Tips & Tricks</a>
+    </li>	
     <li class="toctree-l1">
 	<a href="/business/index.html">Varnish Business</a>
     </li>	

R1/source/index.rst

@@ -35,10 +35,10 @@ Future Events
 `Varnish Cache Meetup #2 <http://www.meetup.com/Paris-Varnish-Cache-Meetup/events/229789817/>`_
 
 2016-05-11 (Sydney) `Varnish-Software Summit
-<http://info.varnish-software.com/sydney-summit-2016>`_
+<http://info.varnish-software.com/sydney-summit-2016>`__
 
 2016-05-13 (Auckland) `Varnish-Software Summit
-<http://info.varnish-software.com/nz-summit-2016>`_
+<http://info.varnish-software.com/nz-summit-2016>`__
 
 2016-05-26 (Madrid)
 `Varnish para meros mortales / Drupal Madrid Meetup <http://www.meetup.com/Drupal-Madrid/events/230709381/>`_
@@ -74,3 +74,4 @@ they collect, it will be discontinued.
    support/index
    extras/index
    vmods/index
+   tips/index

R1/source/tips/index.rst

+.. _tips:
+
+Tips & Tricks
+=============
+
+301/302 Redirects
+-----------------
+
+Synthetic responses can be used to generate 30x redirects, and
+the usual way is to stash the new location in req.http.something,
+and move that to resp.location in ``vcl_synth{}``.
+
+Here is a slightly neater way, exploiting the fact that ``return(synth())``
+takes two arguments::
+
+	sub vcl_recv {
+	    if (req.url ~ "^/installation/ubuntu") {
+		return (synth(301, "/releases/install_ubuntu.html"));
+	    }
+	    if (req.url ~ "^/installation/debian") {
+		return (synth(302, "/releases/install_redhat.html"));
+	    }
+	}
+
+	sub vcl_synth {
+	    if (resp.status == 301 || resp.status == 302) {
+		set resp.http.location = resp.reason;
+		set resp.reason = "Moved";
+		return (deliver);
+	    }
+	}
+
+.. toctree::
+	:hidden: