Top level api docs for createFactory

As mentioned in the comments of #2615