documentation updated

includes documentation for:
- application flow
- activity layouts
- alternate options
- interactions
- pros and cons of alternate options
- animations