Fix docs for default groups for docs

Author: lud

lib/ex_doc/retriever.ex

@@ -285,9 +285,10 @@ defmodule ExDoc.Retriever do
   defp get_docs_groups(module_groups, nodes_groups, doc_nodes) do
     module_groups = Enum.map(module_groups, &normalize_group/1)
 
-    # Doc nodes already have normalized groups
     nodes_groups_descriptions = Map.new(nodes_groups, &{&1.title, &1.description})
 
+    # Doc nodes already have normalized groups
+    nodes_groups = ExDoc.Utils.natural_sort_by(nodes_groups, & &1.title)
     normal_groups = module_groups ++ nodes_groups
     nodes_by_group_title = Enum.group_by(doc_nodes, & &1.group)
 

lib/mix/tasks/docs.ex

@@ -402,8 +402,8 @@ defmodule Mix.Tasks.Docs do
   * 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.
+  * Finally, other groups returned by `:default_group_for_doc` by alphabetical
+    order.
 
   ## Meta-tags configuration
 

test/ex_doc/retriever_test.exs

@@ -78,7 +78,7 @@ defmodule ExDoc.RetrieverTest do
 
       config = %ExDoc.Config{}
       {[mod], []} = Retriever.docs_from_modules([A], config)
-      [%{docs: [bar]}, %{docs: [baz]}, %{docs: [foo]}] = mod.docs_groups
+      [%{docs: [foo]}, %{docs: [bar]}, %{docs: [baz]}] = mod.docs_groups
 
       assert %{id: "c:foo/0", group: "a"} = foo
       assert %{id: "bar/0", group: "b"} = bar
@@ -101,7 +101,7 @@ defmodule ExDoc.RetrieverTest do
 
       config = %ExDoc.Config{group_for_doc: & &1[:semi_group]}
       {[mod], []} = Retriever.docs_from_modules([A], config)
-      [%{docs: [bar]}, %{docs: [baz]}, %{docs: [foo]}] = mod.docs_groups
+      [%{docs: [foo]}, %{docs: [bar]}, %{docs: [baz]}] = mod.docs_groups
 
       assert %{id: "c:foo/0", group: "a"} = foo
       assert %{id: "bar/0", group: "b"} = bar