The phrase *should be stripped out* hints too much about specific implementation choices. This javadoc should just describe (declaratively) what plugins can expect for inputs and what's expected for them to produce as outputs (e.g., "a PartitionResult containing the list of candidate partitions and the set of domain mappings that the plugin could not (or chose not to) handle")