Clarify the main purpose of the os argument

This just adds a bit of documentation to indicate that the os argument
is primarily intended for testing rather than end users.

this could be used to close out #4