Extract multitenancy

Author: mylanconnolly

usage-rules.md

@@ -10,73 +10,6 @@ SPDX-License-Identifier: MIT
 
 AshPostgres is the PostgreSQL data layer for Ash Framework. It's the most fully-featured Ash data layer and should be your default choice unless you have specific requirements for another data layer. Any PostgreSQL version higher than 13 is fully supported.
 
-## Multitenancy
-
-AshPostgres supports schema-based multitenancy:
-
-```elixir
-defmodule MyApp.Tenant do
-  use Ash.Resource,
-    data_layer: AshPostgres.DataLayer
-
-  # Resource definition...
-
-  postgres do
-    table "tenants"
-    repo MyApp.Repo
-
-    # Automatically create/manage tenant schemas
-    manage_tenant do
-      template ["tenant_", :id]
-    end
-  end
-end
-```
-
-### Setting Up Multitenancy
-
-1. Configure your repo to support multitenancy:
-
-```elixir
-defmodule MyApp.Repo do
-  use AshPostgres.Repo, otp_app: :my_app
-
-  # Return all tenant schemas for migrations
-  def all_tenants do
-    import Ecto.Query, only: [from: 2]
-    all(from(t in "tenants", select: fragment("? || ?", "tenant_", t.id)))
-  end
-end
-```
-
-2. Mark resources that should be multi-tenant:
-
-```elixir
-defmodule MyApp.Post do
-  use Ash.Resource,
-    data_layer: AshPostgres.DataLayer
-
-  multitenancy do
-    strategy :context
-    attribute :tenant
-  end
-
-  # Resource definition...
-end
-```
-
-3. When tenant migrations are generated, they'll be in `priv/repo/tenant_migrations`
-
-4. Run tenant migrations in addition to regular migrations:
-
-```bash
-# Run regular migrations
-mix ash.migrate
-
-# Run tenant migrations
-mix ash_postgres.migrate --tenants
-```
-
 ## Advanced Features
 
 ### Manual Relationships

usage-rules/multitenancy.md

@@ -0,0 +1,72 @@
+<!--
+SPDX-FileCopyrightText: 2020 Zach Daniel
+
+SPDX-License-Identifier: MIT
+-->
+
+# Multitenancy
+
+AshPostgres supports schema-based multitenancy:
+
+```elixir
+defmodule MyApp.Tenant do
+  use Ash.Resource,
+    data_layer: AshPostgres.DataLayer
+
+  # Resource definition...
+
+  postgres do
+    table "tenants"
+    repo MyApp.Repo
+
+    # Automatically create/manage tenant schemas
+    manage_tenant do
+      template ["tenant_", :id]
+    end
+  end
+end
+```
+
+## Setting Up Multitenancy
+
+1. Configure your repo to support multitenancy:
+
+```elixir
+defmodule MyApp.Repo do
+  use AshPostgres.Repo, otp_app: :my_app
+
+  # Return all tenant schemas for migrations
+  def all_tenants do
+    import Ecto.Query, only: [from: 2]
+    all(from(t in "tenants", select: fragment("? || ?", "tenant_", t.id)))
+  end
+end
+```
+
+2. Mark resources that should be multi-tenant:
+
+```elixir
+defmodule MyApp.Post do
+  use Ash.Resource,
+    data_layer: AshPostgres.DataLayer
+
+  multitenancy do
+    strategy :context
+    attribute :tenant
+  end
+
+  # Resource definition...
+end
+```
+
+3. When tenant migrations are generated, they'll be in `priv/repo/tenant_migrations`
+
+4. Run tenant migrations in addition to regular migrations:
+
+```bash
+# Run regular migrations
+mix ash.migrate
+
+# Run tenant migrations
+mix ash_postgres.migrate --tenants
+```