userguide: iteration on the new docs

Signed-off-by: Pierre-Alexandre Meyer <pierre@mouraf.org>