doc: merge guide 2 with guide

Doing this doc change as a pull cause the changes are big and I wanted someone else to go through it at least once, before guide2 is merged into/replaces the old Guide.