andrewchambers/errors.md

## errors.md

      
    Raw
  

              errors.md
            
          
    In my own code, I use my own error package. My observation
is that a root cause of an error is special, most values in the
error chain are useless except to preserve line information. Users
and debuggers usually only care about the first error and the last
error in the chain.
A typical formatting of an error is "Unable to ${TOP_ACTION}: ${ROOT_CAUSE}"
A typical usage of my package is:
err := errors.Wrapf(err, "Additional context: %s", s)
...
if errors.RootCause(err) != sql.ErrNoRows {
  Log("an error happend", "trace", errors.Trace(err))
}

One big lack I found is knowing the possible values of RootCause... A Go guru
like analysis may help. especially a way to check reality with what the
doc comments say.