Ensure default groups are displayed last

Author: lud

lib/ex_doc/retriever.ex

@@ -148,7 +148,8 @@ defmodule ExDoc.Retriever do
 
     docs_groups =
       get_docs_groups(
-        moduledoc_groups ++ config.docs_groups ++ module_data.default_groups,
+        moduledoc_groups ++ config.docs_groups,
+        module_data.default_groups,
         nodes_groups,
         docs
       )
@@ -282,13 +283,13 @@ defmodule ExDoc.Retriever do
     end)
   end
 
-  defp get_docs_groups(module_groups, nodes_groups, doc_nodes) do
+  defp get_docs_groups(module_groups, default_groups, nodes_groups, doc_nodes) do
     module_groups = Enum.map(module_groups, &normalize_group/1)
-
+    default_groups = Enum.map(default_groups, &normalize_group/1)
     # Doc nodes already have normalized groups
     nodes_groups_descriptions = Map.new(nodes_groups, &{&1.title, &1.description})
 
-    normal_groups = module_groups ++ nodes_groups
+    normal_groups = module_groups ++ nodes_groups ++ default_groups
     nodes_by_group_title = Enum.group_by(doc_nodes, & &1.group)
 
     {docs_groups, _} =

lib/mix/tasks/docs.ex

@@ -400,10 +400,11 @@ defmodule Mix.Tasks.Docs do
   rules:
 
   * First, groups defined as `@moduledoc groups: [...]` in the given order.
-  * Then groups defined as keys in the `:groups_for_docs` configuration.
-  * Then default groups: Types, Callbacks and Functions.
-  * Finally, other groups returned by `:default_group_for_doc` by order of
-    appearance of their belonging elements.
+  * Then groups defined as keys in the `:groups_for_docs` configuration, in the
+    given order.
+  * Then, other groups returned by `:default_group_for_doc` by alphabetical order
+    of their belonging elements (by function name).
+  * Finally the default groups: Types, Callbacks and Functions.
 
   ## Meta-tags configuration