document factory methods & properties
Merge pull request #23 from nickb1080/more-docs

document factory methods & properties