=str write intro to docs

NOT YET CORRECTLY LINKED
Teaching at my uni would give me a rather anecdotical estimate of 20%-80% of top-down vs. bottom-up rates. Although the more clearer picture is probably 10% pure top-down, 20% pure bottom-up, 70% mixed. And this ends our "made up statistics daily" programme :)