prerequisites for installation, cache sizing guidelines + some general cleanup

git-svn-id: http://www.varnish-cache.org/svn/trunk/varnish-cache@4996 d4fa192b-c00b-0410-8231-f00ffab90ce4

doc/sphinx/index.rst

@@ -30,3 +30,6 @@ Indices and tables
 * :ref:`genindex`
 * :ref:`modindex`
 * :ref:`search`
+
+
+`$Id:$`

doc/sphinx/installation/index.rst

@@ -4,29 +4,16 @@
 Varnish Installation
 %%%%%%%%%%%%%%%%%%%%
 
-This manual explains how to get Varnish onto your system, where
+This document explains how to get Varnish onto your system, where
 to get help, how report bugs etc.  In other words, it is a manual
 about pretty much everything else than actually using Varnish to
 move traffic.
 
 .. toctree::
 
+	prerequisites.rst
 	install.rst
 	help.rst
 	bugs.rst
 
-.. todo::
-        [V] on this os, pull this package
-        [V] .. that ..//..
-        [V] to compile from source
-        [V] how to get help
-        [V]- mailing list
-        [V] - IRC
-        [V] - varnish-software.com
-        [V] - other listed consultants
-        reporting bugs
-        - using varnishtest to reproduce
-        - what data do we need
-        - confidentiality
-        - ...
 

doc/sphinx/installation/prerequisites.rst

+Prerequisites
+=============
+
+
+In order for you to install Varnish you must have the following:
+
+  * A fairly modern and 64 bit version of either
+    - Linux
+    - FreeBSD
+    - Solaris
+  * root access to said system
+
+
+Varnish can be installed on other UNIX systems as well, but it is not
+tested particularly well on these plattforms. Varnish is, from time to
+time, said to work on: 
+
+  * 32 bit versions of the before-mentioned systems.
+  * OS X
+  * NetBSD
+  * OpenBSD
+

doc/sphinx/tutorial/index.rst

@@ -4,7 +4,7 @@
 Varnish Tutorial
 %%%%%%%%%%%%%%%%
 
-Varnish is a web accelerator. It is installed in frond of your web
+Varnish is a web accelerator. It is installed in front of your web
 application and it caches the reponses, making your web site run  Varnish
 is fast, flexible and easy to use.
 
@@ -18,13 +18,16 @@ and that you want to accelerate this application with Varnish.
 Furthermore we assume you have read the :ref:`install-index` and that
 it is installed with the default configuration.
 
+Good luck.
 
+perbu.
 
 .. toctree:: 
 
 	backend_servers.rst
         starting_varnish.rst
 	logging.rst
+        sizing_your_cache.rst
         putting_varnish_on_port_80.rst
 	vcl.rst
         statistics.rst

doc/sphinx/tutorial/sizing_your_cache.rst

+
+Sizing your cache
+-----------------
+
+Picking how much memory you should give Varnish can be a tricky
+task. A few things to consider:
+ * How big is your *hot* data set. For a portal or news site that
+   would be the size of the front page with all the stuff on it, and
+   the size of all the pages and objects linked from the first page. 
+ * How expensive is it to generate an object? Sometimes it makes sense
+   to only cache images a little while or not to cache them at all if
+   they are cheap to serve from the backend and you have a limited
+   amount of memory.
+ * Watch the n_lru_nuked counter with varnishstat or some other
+   tool. If you have a lot of LRU activity then you should consider
+   increasing the size of the cache.

doc/sphinx/tutorial/starting_varnish.rst

@@ -4,7 +4,7 @@ Starting Varnish
 ----------------
 
 I assume varnishd is in your path. You might want to run ``pkill
-varnishd`` to make sure Varnish isn't running. Become root and type:
+varnishd`` to make sure varnishd isn't running. Become root and type:
 
 ``# varnishd -f /usr/local/etc/varnish/default.vcl -s malloc,1G -T 127.0.0.1:2000 -a 0.0.0.0:8080``
 
@@ -18,7 +18,7 @@ I added a few options, lets go through them:
  storing its content. I used the type *malloc*, which just uses memory
  for storage. There are other backends as well, described in 
  :ref:tutorial-storage. 1G specifies how much memory should be allocated 
- - one gigabyte.
+ - one gigabyte. 
 
 ``-T 127.0.0.1:2000``
  Varnish has a buildt in text-based administration