Update documentation to match code behavior after previous changes, also reword the examples section.