updates to docs, removing public property caveat, and mentioning inheritance need orders in ctor provisions