Scenic extension prepend instead of include

Gemfile.scenic.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    timescaledb (0.2.7)
+    timescaledb (0.2.8)
       activerecord
       activesupport
       pg (~> 1.2)
@@ -56,7 +56,7 @@ GEM
     nokogiri (1.12.5)
       mini_portile2 (~> 2.6.1)
       racc (~> 1.4)
-    pg (1.4.5)
+    pg (1.5.6)
     pry (0.14.1)
       coderay (~> 1.1)
       method_source (~> 1.0)

docs/migrations.md

@@ -25,6 +25,18 @@ end
 This example shows a ticks table grouping ticks as OHLCV histograms for every
 minute.
 
+First make sure you have the model with the `acts_as_hypertable` method to be
+able to extract the query from it.
+
+```ruby
+class Tick < ActiveRecord::Base
+  self.table_name = 'ticks'
+  acts_as_hypertable
+end
+```
+
+Then, inside your migration:
+
 ```ruby
 hypertable_options = {
   time_column: 'created_at',
@@ -39,11 +51,6 @@ create_table :ticks, hypertable: hypertable_options, id: false do |t|
   t.integer :volume
   t.timestamps
 end
-Tick = Class.new(ActiveRecord::Base) do
-  self.table_name = 'ticks'
-  self.primary_key = 'symbol'
-  acts_as_hypertable
-end
 
 query = Tick.select(<<~QUERY)
   time_bucket('1m', created_at) as time,
@@ -73,4 +80,21 @@ If you're interested in candlesticks and need to get the OHLC values, take a loo
 at the [toolkit ohlc](/toolkit_ohlc) function that do the same but through a
 function that can be reusing candlesticks from smaller timeframes.
 
+!!! note "Disable ddl transactions in your migration to start with data"
+
+    If you want to start `with_data: true`, remember that you'll need to
+    `disable_ddl_transaction!` in your migration file.
+
+    ```ruby
+    class CreateCaggsWithData < ActiveRecord::Migration[7.0]
+      disable_ddl_transaction!
+
+      def change
+        create_continuous_aggregate('ohlc_1m', query, with_data: true)
+        # ...
+      end
+    end
+    ```
+
+
 [1]: https://ideia.me/timescale-continuous-aggregates-with-ruby

lib/timescaledb/scenic/extension.rb

@@ -25,7 +25,6 @@ def create_materialized_view(name, sql_definition, with: nil, no_data: false)
 
       # @override Scenic::Adapters::Postgres#create_view
       # to add the `with: ` keyword that can be used for such option.
-      #
       def create_view(name, version: nil, with: nil, sql_definition: nil, materialized: false, no_data: false)
         if version.present? && sql_definition.present?
           raise(
@@ -69,4 +68,4 @@ def create_scenic_continuous_aggregate(name)
 
 
 Scenic::Adapters::Postgres.include(Timescaledb::Scenic::Extension)
-ActiveRecord::ConnectionAdapters::AbstractAdapter.include(Timescaledb::Scenic::MigrationHelpers)
+ActiveRecord::ConnectionAdapters::AbstractAdapter.prepend(Timescaledb::Scenic::MigrationHelpers)