Fixed chapter 2 parsing problems but not yet the versions history - needs discussion on how to fix it :)
Merge pull request #2863 from noctarius/docs-fix-chapter-2

Fixed chapter 2 parsing problems but not yet the versions history - need...