diff --git a/Yesod/Auth/HashDB.hs b/Yesod/Auth/HashDB.hs
--- a/Yesod/Auth/HashDB.hs
+++ b/Yesod/Auth/HashDB.hs
@@ -12,7 +12,7 @@
 -------------------------------------------------------------------------------
 -- |
 -- Module      :  Yesod.Auth.HashDB
--- Copyright   :  (c) Patrick Brisbin 2010, Paul Rouse 2014
+-- Copyright   :  (c) Patrick Brisbin 2010, Paul Rouse 2014-2015
 -- License     :  MIT
 --
 -- Maintainer  :  Paul Rouse <pyr@doynton.org>
@@ -81,21 +81,23 @@
 -- In the YesodAuth instance declaration for your app, include 'authHashDB'
 -- like so:
 --
--- > import Yesod.Auth.HashDB (authHashDB, getAuthIdHashDB)
+-- > import Yesod.Auth.HashDB (authHashDB)
 -- > ....
 -- > instance YesodAuth App where
 -- >     ....
 -- >     authPlugins _ = [ authHashDB (Just . UniqueUser), .... ]
--- >     getAuthId = getAuthIdHashDB AuthR (Just . UniqueUser)  -- Optional, see below
+-- >     getAuthId creds = ... -- Perhaps modify scaffolding: see below
 --
--- @AuthR@ should be your authentication route, and the function
--- @(Just . UniqueUser)@ supplied to both 'authHashDB' and
--- 'getAuthIdHashDB' takes a 'Text' and produces a 'Unique' value to
--- look up in the User table.  In a scaffolded site you may not need to
--- change the definition of @getAuthId@ at all, or you may prefer to modify
--- the function which the scaffolding defines: 'getAuthIdHashDB' is just a
--- convenience for the case when 'HashDB' is the only plugin.
+-- The argument to 'authHashDB' is a function which takes a 'Text' and
+-- produces a 'Maybe' containing a 'Unique' value to look up in the User
+-- table.  The example @(Just . UniqueUser)@ shown here works for the
+-- model outlined above.
 --
+-- In the scaffolding, the definition of @getAuthId@ contains code to
+-- add a user who is not already in the database.  Depending on how users
+-- are administered, this may not make sense when using HashDB, so consider
+-- whether it should be removed.
+--
 -- For a real application, the developer should provide some sort of
 -- of administrative interface for setting passwords; it needs to call
 -- 'setPassword' and save the result in the database.  However, if you
@@ -406,6 +408,8 @@
                     mr <- getMessageRender
                     _ <- loginErrorMessage (authR LoginR) (mr Msg.InvalidUsernamePass)
                     return Nothing
+
+{-# DEPRECATED getAuthIdHashDB "If this is a problem, please discuss at <https://github.com/paul-rouse/yesod-auth-hashdb/issues/5>" #-}
 
 -- | Prompt for username and password, validate that against a database
 --   which holds the username and a hash of the password
diff --git a/test/NonDBTests.hs b/test/NonDBTests.hs
--- a/test/NonDBTests.hs
+++ b/test/NonDBTests.hs
@@ -9,6 +9,8 @@
 
 import ExampleData
 
+-- For consistent layout of "it" items, we sometimes have a redundant "do":
+{-# ANN nonDBTests ("HLint: ignore Redundant do"::String) #-}
 
 nonDBTests :: Spec
 nonDBTests = do
diff --git a/yesod-auth-hashdb.cabal b/yesod-auth-hashdb.cabal
--- a/yesod-auth-hashdb.cabal
+++ b/yesod-auth-hashdb.cabal
@@ -1,5 +1,5 @@
 name:            yesod-auth-hashdb
-version:         1.4.1.2
+version:         1.4.2
 license:         MIT
 license-file:    LICENSE
 author:          Patrick Brisbin, later changes Paul Rouse