   end
 
 
-  @doc "Find element within element"
+  @doc """
+  Finds element within a specific element. Returns an element ID to use with element helper functions.
+
+  * The first argument is the element ID of the element within which you want to search.
+  * The second argument is the strategy.
+  * The third argument is the selector.
+
+  Valid selector strategies are `:css`, `:class`, `:id`, `:name`, `:tag`, `:xpath`, `:link_text` and `:partial_link_text`
+
+      # First get an element ID to search within
+      parent_element_id = find_element(:class, "container")
+
+      find_within_element(parent_element_id, :name, "username")
+      find_within_element(parent_element_id, :class, "example")
+      find_within_element(parent_element_id, :id, "example")
+      find_within_element(parent_element_id, :css, ".example")
+      find_within_element(parent_element_id, :tag, "footer")
+      find_within_element(parent_element_id, :link_text, "Home")
+  """
   @spec find_within_element(String.t, atom,String.t) :: Dict.t
   def find_within_element(element_id, strategy, selector) do
     session_id = Hound.get_current_session_id

defmodule Hound.JsonDriver.Page do
  import Hound.JsonDriver.Utils

  @doc "Get source of current page"
  @spec page_source() :: String.t
  def page_source() do
    session_id = Hound.get_current_session_id

  end


  @doc """
  Finds elements on current page. Returns an array of element IDs that can be used with other element functions.

  * The first argument is the strategy.
  * The second argument is the selector.

  Valid selector strategies are `:css`, `:class`, `:id`, `:name`, `:tag`, `:xpath`, `:link_text` and `:partial_link_text`

      find_elements(:name, "username")
      find_elements(:class, "example")
      find_elements(:id, "example")
      find_elements(:css, ".example")
      find_elements(:tag, "footer")
      find_elements(:link_text, "Home")
  """
  @spec find_all_elements(atom, String.t) :: List.t
  def find_all_elements(strategy, selector) do
    session_id = Hound.get_current_session_id
