Sure - I think that is fine for the docstring.  I think this will come down to a good clear introduction to the system and it's scope in the docs.