DOC: 4.methods.md - improvements