adding documentation on exceptions and extending the storage spec