doc: moved important sections to the front. thanks Pierre-Yves Gérardy for the patch in #371.