Add comments for public interfaces

Fixes #27