more documentation + bool attrs