To start, rework the examples and the inner workings of classes. Many users/developers learn from these, and copy code fragments from these, and we could do better at setting a good example. The API will have to evolve if we decide to move in that direction.