Framework Scaladoc on Nested Suites

Added more text about nested suites behavior to Framework scaladoc.