docs: clarify load option only works with Elixir calculations

Author: barnabasJ

documentation/dsls/DSL-Ash.Resource.md

@@ -3752,7 +3752,7 @@ end
 | [`description`](#calculations-calculate-description){: #calculations-calculate-description } | `String.t` |  | An optional description for the calculation |
 | [`public?`](#calculations-calculate-public?){: #calculations-calculate-public? } | `boolean` | `false` | Whether or not the calculation will appear in public interfaces. |
 | [`sensitive?`](#calculations-calculate-sensitive?){: #calculations-calculate-sensitive? } | `boolean` | `false` | Whether or not references to the calculation will be considered sensitive. |
-| [`load`](#calculations-calculate-load){: #calculations-calculate-load } | `any` | `[]` | A load statement to be applied if the calculation is used. |
+| [`load`](#calculations-calculate-load){: #calculations-calculate-load } | `any` | `[]` | A load statement to be applied if the calculation is used. Only works with module-based or function-based calculations, not expression calculations. |
 | [`allow_nil?`](#calculations-calculate-allow_nil?){: #calculations-calculate-allow_nil? } | `boolean` | `true` | Whether or not the calculation can return nil. |
 | [`filterable?`](#calculations-calculate-filterable?){: #calculations-calculate-filterable? } | `boolean \| :simple_equality` | `true` | Whether or not the calculation should be usable in filters. |
 | [`sortable?`](#calculations-calculate-sortable?){: #calculations-calculate-sortable? } | `boolean` | `true` | Whether or not the calculation can be referenced in sorts. |

documentation/topics/advanced/manual-installation.md

@@ -25,15 +25,38 @@ config :spark, formatter: [remove_parens?: true]
 
 ```
 
-Update `mix.exs`:
-```diff
-...
-    defp deps do
-      [
-+       {:sourceror, "~> 1.8", only: [:dev, :test]}
-        # {:dep_from_hexpm, "~> 0.3.0"},
-        # {:dep_from_git, git: "https://github.com/elixir-lang/my_dep.git", tag: "0.1.0"}
-...
+Create `mix.exs`:
+```
+defmodule Elixir.Test.MixProject do
+  use Mix.Project
+
+  def project do
+    [
+      app: :test,
+      version: "0.1.0",
+      elixir: "~> 1.17",
+      start_permanent: Mix.env() == :prod,
+      deps: deps()
+    ]
+  end
+
+  # Run "mix help compile.app" to learn about applications.
+  def application do
+    [
+      extra_applications: [:logger]
+    ]
+  end
+
+  # Run "mix help deps" to learn about dependencies.
+  defp deps do
+    [
+      {:sourceror, "~> 1.8", only: [:dev, :test]}
+      # {:dep_from_hexpm, "~> 0.3.0"},
+      # {:dep_from_git, git: "https://github.com/elixir-lang/my_dep.git", tag: "0.1.0"}
+    ]
+  end
+end
+
 ```
 
 Update `.formatter.exs`:

lib/ash/resource/calculation/calculation.ex

@@ -72,7 +72,10 @@ defmodule Ash.Resource.Calculation do
     load: [
       type: :any,
       default: [],
-      doc: "A load statement to be applied if the calculation is used."
+      doc: """
+      A load statement to be applied if the calculation is used.
+      Only works with module-based or function-based calculations, not expression calculations.
+      """
     ],
     allow_nil?: [
       type: :boolean,
@@ -188,6 +191,10 @@ defmodule Ash.Resource.Calculation do
   @callback calculate(records :: [Ash.Resource.record()], opts :: opts, context :: Context.t()) ::
               {:ok, [term]} | [term] | {:error, term} | :unknown
   @callback expression(opts :: opts, context :: Context.t()) :: any
+  @doc """
+  A load statement to be applied when the calculation is used.
+  Only works with module-based or function-based calculations, not expression calculations.
+  """
   @callback load(query :: Ash.Query.t(), opts :: opts, context :: Context.t()) ::
               atom | [atom] | Keyword.t()
   @callback strict_loads?() :: boolean()