fix: doc issues

Author: MikaAK

docs/overview.md

@@ -12,8 +12,6 @@ ErrorMessage is a library designed to simplify error handling in Elixir applicat
 
 ## Documentation Structure
 
-This documentation follows the [Diátaxis framework](https://diataxis.fr/), which organizes documentation into four distinct types:
-
 1. **Tutorials**: Step-by-step lessons to help you get started with ErrorMessage
 2. **How-To Guides**: Practical guides for solving specific problems
 3. **Explanation**: Conceptual discussions about ErrorMessage's design and principles

docs/reference/serialization.md

@@ -63,7 +63,7 @@ If a request ID is available in the Logger metadata, it will be included:
 
 ### Data Type Handling
 
-The `ErrorMessage.Serializer` module includes the `ensure_json_serializable/1` function, which handles conversion of Elixir-specific data types to JSON-compatible formats:
+The ErrorMessage.Serializer module includes the `ensure_json_serializable/1` function, which handles conversion of Elixir-specific data types to JSON-compatible formats:
 
 | Elixir Type | JSON Representation |
 |-------------|---------------------|

docs/tutorials/getting_started.md

@@ -118,8 +118,8 @@ end
 
 Now that you understand the basics of ErrorMessage, you can:
 
-- Check out the [How-To Guides](/docs/how-to-guides/) for practical examples
-- Explore the [Explanation](/docs/explanation/) section to understand the design principles
-- Refer to the [API Reference](/api-reference.html) for detailed function documentation
+- Check out the [How-To Guides](https://hexdocs.pm/error_message/how-to-guides.html) for practical examples
+- Explore the [Explanation](https://hexdocs.pm/error_message/explanation.html) section to understand the design principles
+- Refer to the [API Reference](https://hexdocs.pm/error_message/api-reference.html) for detailed function documentation
 
 Congratulations! You've completed the getting started tutorial for ErrorMessage.

mix.exs

@@ -43,8 +43,8 @@ defmodule ErrorMessage.MixProject do
       {:credo, "~> 1.6", only: [:test, :dev], runtime: false},
       {:blitz_credo_checks, "~> 0.1", only: [:test, :dev], runtime: false},
 
-      {:excoveralls, "~> 0.10", only: :test},
-      {:ex_doc, ">= 0.0.0", optional: true, only: :dev},
+      {:excoveralls, "~> 0.10", only: :test, runtime: false},
+      {:ex_doc, ">= 0.0.0", optional: true, only: :dev, runtime: false},
       {:dialyxir, "~> 1.0", optional: true, only: :test, runtime: false}
     ]
   end
@@ -54,7 +54,7 @@ defmodule ErrorMessage.MixProject do
       maintainers: ["Mika Kalathil"],
       licenses: ["MIT"],
       links: %{"GitHub" => "https://github.com/MikaAK/elixir_error_message"},
-      files: ~w(mix.exs README.md CHANGELOG.md lib)
+      files: ~w(mix.exs README.md CHANGELOG.md lib docs)
     ]
   end
 
@@ -65,20 +65,24 @@ defmodule ErrorMessage.MixProject do
       extra_section: "DOCUMENTATION",
       extras: [
         "docs/overview.md",
+        "docs/how-to-guides/error_handling_patterns.md",
+        "docs/how-to-guides/phoenix_integration.md",
+        "docs/explanation/error_design_principles.md",
+        "docs/explanation/error_handling_in_elixir.md",
+        "docs/reference/api_reference.md",
+        "docs/reference/serialization.md",
+        "docs/tutorials/error_handling_workflow.md",
+        "docs/tutorials/getting_started.md",
         "CHANGELOG.md"
       ],
       groups_for_extras: [
-        "Guides": [
-          "docs/overview.md",
-        ],
-        "Tutorials": Path.wildcard("docs/tutorials/*.md"),
-        "How-To Guides": Path.wildcard("docs/how-to-guides/*.md"),
-        "Explanation": Path.wildcard("docs/explanation/*.md"),
-        "Reference": Path.wildcard("docs/reference/*.md")
+        Tutorials: ~r/docs\/tutorials\/.?/,
+        "HowTo docs": ~r/docs\/how-to-guides\/.?/,
+        Reference: ~r/docs\/reference\/.?/,
+        Explanation: ~r/docs\/explanation\/.?/
       ],
       groups_for_modules: [
-        "Core": [ErrorMessage],
-        "Serialization": [ErrorMessage.Serializer]
+        "Core": [ErrorMessage]
       ]
     ]
   end