Consistent factory functions in the documentation

Per the discussion in #1430 consistently use the lowercase factory methods in the api documentation.

<!---
@huboard:{"order":1735.0}
-->