document constructors for subclasses in public API