imporoved package documentation.

Added 'safety' section.