add documentation about the targets feature and their behavior