Update reference docs for recent Extension.__init__ refactor.

Noted that using keywords it the prefered method of passing config options to extensions. Also updated the example sto demonstrate the new prefered way as discussed in #325.