various article adjustments
Merge branch 'new' of https://github.com/ppekrol/docs into new