Document `TraitType.read_only`

[vidartf]

By searching the repo, I was able to find this description in the changelog:

Trait attributes initialized with read_only=True can only be set with the set_trait method. Attempts to directly modify a read-only trait attribute raises a TraitError.

This description would be nice to have in docs/docstrings!