Docstrings for the SystemAdapter interface

Docstring clarifying the semantics of the interface. A bit...