Added API documentation
Added notes (todos)
Revert: made framework public again, as it's needed for adapters