Documentation

Does it make sense to add a spec for this to ensure it doesn't regress?