Updated and finished a lot of new docu...

Did not really have the time to do a full review, so there will
probably be a few typos and some section that need to be
updated/changed. But the basic stuff is out there and should be helpful
to get anyone started.