[DOC] add user guide parallelization

Hi;

@stefanv Is it something like this you had in mind for #1036 ? 




Don't we need a return value?