more documentation..
- validation (completed)
- model up next...