This documentation was considered "brief to the point of being
unclear." This expands it with helpful details.