docs/guide - updates