* adding return value examples * shift to console code blocks * cleaning up whitespace and shortening invocation example * reordering diff section