Dynamic viewport without private APIs

Author: axelson

lib/scenic/driver.ex

@@ -887,7 +887,11 @@ defmodule Scenic.Driver do
     name: [type: :atom]
   ]
 
-  @doc false
+  @doc """
+  Validate driver configuration
+
+  Used primarily for dynamic view port creation
+  """
   def validate([]), do: {:ok, []}
 
   def validate(drivers) do

lib/scenic/view_port.ex

@@ -91,6 +91,20 @@ defmodule Scenic.ViewPort do
   leave the scene that thinks it has "captured" the input in an inconsistent
   state, so this is not recommended.
 
+  ## Dynamically Creating View Ports
+
+  Pass in the same set of opts that you would use when starting `Scenic` in your
+  supervision tree. For example:
+
+      opts = [
+        name: name,
+        module: Scenic.Driver.Local,
+        window: [resizeable: false, title: "My Example Scenic App"],
+        on_close: :stop_system
+      ]
+
+      {:ok, [opts]} = Scenic.Driver.validate([opts])
+      Scenic.ViewPort.start_driver(view_port, opts)
   """
 
   @type t :: %ViewPort{