added a $ convenience, a simple factory, updated doc