Add descriptions to Ecto.Repo API groups

Author: rhcarvalho

lib/ecto/repo.ex

@@ -214,6 +214,24 @@ defmodule Ecto.Repo do
 
   """
 
+  @moduledoc groups: [
+               %{title: "Query API", description: "Functions that operate on an `Ecto.Query`."},
+               %{
+                 title: "Schema API",
+                 description: "Functions that operate on an `Ecto.Schema` or a `Ecto.Changeset`."
+               },
+               %{
+                 title: "Transaction API",
+                 description: "Functions to work with database transactions and connections."
+               },
+               %{
+                 title: "Process API",
+                 description: "Functions to work with repository processes."
+               },
+               "Config API",
+               "User callbacks"
+             ]
+
   @type t :: module
 
   @doc """

mix.exs

@@ -63,14 +63,6 @@ defmodule Ecto.MixProject do
       skip_undefined_reference_warnings_on: ["CHANGELOG.md"],
       extras: extras(),
       groups_for_extras: groups_for_extras(),
-      groups_for_docs: [
-        group_for_function("Query API"),
-        group_for_function("Schema API"),
-        group_for_function("Transaction API"),
-        group_for_function("Process API"),
-        group_for_function("Config API"),
-        group_for_function("User callbacks")
-      ],
       groups_for_modules: [
         # Ecto,
         # Ecto.Changeset,
@@ -165,8 +157,6 @@ defmodule Ecto.MixProject do
     ]
   end
 
-  defp group_for_function(group), do: {String.to_atom(group), &(&1[:group] == group)}
-
   defp groups_for_extras do
     [
       Introduction: ~r/guides\/introduction\/.?/,