more documentation fixes and coverage

documentation for:
- generic files
- ActiveRecord specific files