       iex> FunWithFlags.enabled?(:random_glitch)
       false
 
+  ### Enable for a percentage of the actors
+
+  This example is based on the fact that the actor score for the actor-flag pair
+  `marty + :new_ui` is lower than 50%, and for the `buford + :new_ui` is higher.
+
+      iex> FunWithFlags.disable(:new_ui)
+      iex> FunWithFlags.enable(:new_ui, for_percentage_of: {:actors, 0.5})
+      iex> FunWithFlags.enabled?(:new_ui)
+      false
+      iex> alias FunWithFlags.TestUser, as: User
+      iex> marty = %User{id: 42, name: "Marty McFly"}
+      iex> buford = %User{id: 2, name: "Buford Tannen"}
+      iex> FunWithFlags.enabled?(:new_ui, for: marty)
+      true
+      iex> FunWithFlags.enabled?(:new_ui, for: buford)
+      false
+
   """
   @spec enable(atom, options) :: {:ok, true}
   def enable(flag_name, options \\ [])

  to a binary and it's stored and retrieved as a binary. Atoms are
  supported for retro-compatibility with versions <= 0.9)
  * `:for_percentage_of` - used to enable the flag for a percentage
  of time expressed as `{:time, float}`, where float is in the range
  `0.0 < x < 1.0`.

  ## Examples


  end


  def disable(flag_name, [for_percentage_of: {type, ratio}])
  when is_atom(flag_name) and is_float(ratio) do
    inverted_ratio = 1.0 - ratio
    {:ok, true} = enable(flag_name, [for_percentage_of: {type, inverted_ratio}])
    {:ok, false}
  end

