A start at getting docs up to date

Have tried to remove outdated info and update a few obviously obsolete bits.