Add documentation for two interesting cases

@frabcus to review?