Further clarification to custom expressions in index (#618)

Author: emadshaaban92

lib/ecto/migration.ex

@@ -920,6 +920,11 @@ defmodule Ecto.Migration do
       # Create a tsvector GIN index on PostgreSQL
       create index("products", ["(to_tsvector('english', name))"],
                    name: :products_name_vector, using: "GIN")
+
+  If the expression is a column name, it will not be quoted. This may cause issues
+  when the column is named after a reserved word. Consider using an atom instead.
+  For example, the name `offset` is reserved in many databases so the following
+  could produce an error: `create index("products", ["offset"])`.
   """
   def index(table, columns, opts \\ [])