docs: docs overhaul

README.md

@@ -1,20 +1,19 @@
-![Elixir CI](https://github.com/ash-project/ash_csv/workflows/Ash%20CI/badge.svg)
+![Logo](https://github.com/ash-project/ash/blob/main/logos/cropped-for-header-black-text.png?raw=true#gh-light-mode-only)
+![Logo](https://github.com/ash-project/ash/blob/main/logos/cropped-for-header-white-text.png?raw=true#gh-dark-mode-only)
+
+![Elixir CI](https://github.com/ash-project/ash_csv/workflows/CI/badge.svg)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Hex version badge](https://img.shields.io/hexpm/v/ash_csv.svg)](https://hex.pm/packages/ash_csv)
+[![Hexdocs badge](https://img.shields.io/badge/docs-hexdocs-purple)](https://hexdocs.pm/ash_csv)
+
 # AshCsv
 
-A CSV data layer for Ash. 
+Welcome! This is the CSV Data Layer for [Ash Framework](https://hexdocs.pm/ash).
+
+## Tutorials
 
-## Installation
+- [Getting Started with GraphQL](documentation/tutorials/getting-started-with-ash-csv.md)
 
-```elixir
-def deps do
-  [
-    {:ash_csv, "~> 0.9.7-rc.0"}
-  ]
-end
-```
+## Reference
 
-Documentation can be generated with [ExDoc](https://github.com/elixir-lang/ex_doc)
-and published on [HexDocs](https://hexdocs.pm). Once published, the docs can
-be found at [https://hexdocs.pm/ash_csv](https://hexdocs.pm/ash_csv).
+- [AshCsv.DataLayer DSL](documentation/dsls/DSL:-AshCsv.DataLayer.md)

config/config.exs

@@ -14,6 +14,6 @@ if Mix.env() == :dev do
     manage_mix_version?: true,
     # Instructs the tool to manage the version in your README.md
     # Pass in `true` to use `"README.md"` or a string to customize
-    manage_readme_version: "README.md",
+    manage_readme_version: ["README.md", "documentation/tutorials/getting-started-with-csv.md"],
     version_tag_prefix: "v"
 end

documentation/tutorials/getting-started-with-ash-csv.md

@@ -0,0 +1,13 @@
+# Getting Started with CSV
+
+AshCsv offers basic support for storing and reading resources from csv files.
+
+## Installation
+
+Add `ash_csv` to your list of dependencies in `mix.exs`:
+
+```elixir
+{:ash_csv, "~> 0.9.7-rc.0"}
+```
+
+For information on how to configure it, see the [DSL documentation.](/documentation/dsls/DSL:-AshCsv.DataLayer.md)

mix.exs

@@ -3,7 +3,7 @@ defmodule AshCsv.MixProject do
 
   @version "0.9.7-rc.0"
 
-  @description "A CSV data layer for Ash"
+  @description "The CSV data layer for Ash Framework"
 
   def project do
     [
@@ -31,7 +31,7 @@ defmodule AshCsv.MixProject do
 
   defp docs do
     [
-      main: "get-started-with-csv",
+      main: "readme",
       source_ref: "v#{@version}",
       before_closing_head_tag: fn type ->
         if type == :html do
@@ -49,7 +49,8 @@ defmodule AshCsv.MixProject do
         end
       end,
       extras: [
-        "documentation/tutorials/get-started-with-csv.md",
+        {"README.md", title: "Home"},
+        "documentation/tutorials/getting-started-with-ash-csv.md",
         "documentation/dsls/DSL:-AshCsv.DataLayer.md"
       ],
       groups_for_extras: [