added intro and new methods section

Added to usuallycwdillon's latest; should be back on track now.