renamed Caveats section to "Making ES work" to be consistent with intro

... also reordered the content of the section, adding a bit here and
there and compacting source code