Library API Design error returns: nil vs error tuple vs exception

The library for which I raised this sample for has a similar type :slight_smile:

  @typedoc """
  The samples to compute statistics from.

  Importantly this list is not empty/includes at least one sample otherwise an `ArgumentError` will be raised.
  """
  @type samples :: [sample, ...]
1 Like