docs: reformat docs and revisit certain guides

improvement: support `mix ash.rollback` with interactive rollback

Author: zachdaniel

config/config.exs

@@ -18,6 +18,8 @@ if Mix.env() == :test do
   config :ash, :validate_domain_resource_inclusion?, false
   config :ash, :validate_domain_config_inclusion?, false
 
+  config :ash_postgres, :ash_domains, [AshPostgres.Test.Domain]
+
   config :ash_postgres, AshPostgres.TestRepo,
     username: "postgres",
     database: "ash_postgres_test",

documentation/dsls/DSL:-AshPostgres.DataLayer.md

@@ -52,7 +52,7 @@ end
 | [`migration_ignore_attributes`](#postgres-migration_ignore_attributes){: #postgres-migration_ignore_attributes } | `list(atom)` | `[]` | A list of attributes that will be ignored when generating migrations. |
 | [`table`](#postgres-table){: #postgres-table } | `String.t` |  | The table to store and read the resource from. If this is changed, the migration generator will not remove the old table. |
 | [`schema`](#postgres-schema){: #postgres-schema } | `String.t` |  | The schema that the table is located in. Schema-based multitenancy will supercede this option. If this is changed, the migration generator will not remove the old schema. |
-| [`polymorphic?`](#postgres-polymorphic?){: #postgres-polymorphic? } | `boolean` | `false` | Declares this resource as polymorphic. See the [polymorphic resources guide](/documentation/topics/polymorphic_resources.md) for more. |
+| [`polymorphic?`](#postgres-polymorphic?){: #postgres-polymorphic? } | `boolean` | `false` | Declares this resource as polymorphic. See the [polymorphic resources guide](/documentation/topics/resources/polymorphic-resources.md) for more. |
 
 
 ## postgres.custom_indexes

documentation/home.md

@@ -0,0 +1,32 @@
+# AshPostgres Documentation
+
+Welcome! This documentation is for `AshPostgres`, the PostgreSQL data layer for [Ash Framework](https://hexdocs.pm/ash). If you have not yet, please see the [Ash Framework documentation](https://hexdocs.pm/ash).
+
+## Dive In
+
+- [Get Started](documentation/tutorials/get-started-with-postgres.md)
+
+---
+
+## Tutorials
+
+- [Get Started](documentation/tutorials/get-started-with-postgres.md)
+
+## Topics
+
+### Resources
+
+- [References](documentation/topics/resources/references.md)
+- [Polymorphic Resources](documentation/topics/resources/polymorphic-resources.md)
+
+### Development
+
+- [Migrations and tasks](documentation/topics/development/migrations-and-tasks.md)
+- [Testing](documentation/topics/development/testing.md)
+- [Upgrading to 2.0](documentation/topics/development/upgrading-to-2.0.md)
+
+### Advanced
+
+- [Expressions](documentation/topics/advanced/expressions.md)
+- [Manual Relationships](documentation/topics/advanced/manual-relationships.md)
+- [Schema Based Multitenancy](documentation/topics/advanced/schema-based-multitenancy.md)

documentation/how_to/using-fragments.md

@@ -0,0 +1,77 @@
+# Expressions
+
+In addition to the expressions listed in the [Ash expressions guide](https://hexdocs.pm/ash/expressions.html), AshPostgres provides the following expressions
+
+# Fragments
+
+Fragments allow you to use arbitrary postgres expressions in your queries. Fragments can often be an escape hatch to allow you to do things that don't have something officially supported with Ash.
+
+### Examples
+
+#### Simple expressions
+
+```elixir
+fragment("? / ?", points, count)
+```
+
+#### Calling functions
+
+```elixir
+fragment("repeat('hello', 4)")
+```
+
+#### Using entire queries
+
+```elixir
+fragment("points > (SELECT SUM(points) FROM games WHERE user_id = ? AND id != ?)", user_id, id)
+```
+
+> ### a last resport {: .warning}
+>
+> Using entire queries as shown above is a last resort, but can sometimes be the best way to accomplish a given task.
+
+####  In calculations
+
+```elixir
+calculations do
+  calculate :lower_name, :string, expr(
+    fragment("LOWER(?)", name)
+  )
+end
+```
+
+#### In migrations
+
+```elixir
+create table(:managers, primary_key: false) do
+  add :id, :uuid, null: false, default: fragment("UUID_GENERATE_V4()"), primary_key: true
+end
+```
+
+## Like and ILike
+
+These wrap the postgres builtin like and ilike operators.
+
+Please be aware, these match *patterns* not raw text. Use `contains/1` if you want to match text without supporting patterns, i.e `%` and `_` have semantic meaning!
+
+For example:
+
+```elixir
+Ash.Query.filter(User, like(name, "%obo%")) # name contains obo anywhere in the string, case sensitively
+```
+
+```elixir
+Ash.Query.filter(User, ilike(name, "%ObO%")) # name contains ObO anywhere in the string, case insensitively
+```
+
+## Trigram similarity
+
+To use this expression, you must have the `pg_trgm` extension in your repos `installed_extensions` list.
+
+This calls the `similarity` function from that extension. See more https://www.postgresql.org/docs/current/pgtrgm.htmlhere: https://www.postgresql.org/docs/current/pgtrgm.html
+
+For example:
+
+```elixir
+Ash.Query.filter(User, trigram_similarity(first_name, "fred") > 0.8)
+```

documentation/topics/advanced/expressions.md

@@ -1,4 +1,4 @@
-# Join Manual Relationships
+# Manual Relationships
 
 See [Defining Manual Relationships](https://hexdocs.pm/ash/defining-manual-relationships.html) for an idea of manual relationships in general.
 Manual relationships allow for expressing complex/non-typical relationships between resources in a standard way.

…tion/how_to/join-manual-relationships.md …/topics/advanced/manual-relationships.mddocumentation/how_to/join-manual-relationships.md renamed to documentation/topics/advanced/manual-relationships.md documentation/how_to/join-manual-relationships.md renamed to documentation/topics/advanced/manual-relationships.md

@@ -1,4 +1,4 @@
-# Testing With Postgres
+# Testinging with AshPostgres
 
 When using AshPostgres resources in tests, you will likely want to include use a test case similar to the following. This will ensure that your repo runs everything in a transaction.
 

…tion/topics/schema-based-multitenancy.md …cs/advanced/schema-based-multitenancy.mddocumentation/topics/schema-based-multitenancy.md renamed to documentation/topics/advanced/schema-based-multitenancy.md documentation/topics/schema-based-multitenancy.md renamed to documentation/topics/advanced/schema-based-multitenancy.md

@@ -1,4 +1,4 @@
-# Upgrade from 1.0 to 2.0
+# Upgrading to 2.0
 
 There are only three breaking changes in this release, one of them is very significant, the other two are minor.