Nth PR on develop branch for easybuild-docs, for N=5

still bits and pieces to improve, but ok to receive the first round of feedback
full sentence, make this a note rather than a tip: 

Debug log files are significantly larger than non-debug logs, so be aware.