fix: docusaurus config, sidebar, and tasks docs improvements

- Fix prism-react-renderer import for Docusaurus 3.x compatibility
- Fix sidebar.js: replace missing doc IDs with actual files (data-sources, backtest_data)
- tasks.md: add class-level attribute pattern alongside constructor pattern
- Add show_docs.sh script for running docs locally (with --build option)

Author: MDUYN

docusaurus/docs/Getting Started/tasks.md

@@ -22,7 +22,23 @@ Tasks are automated functions that run on a fixed schedule, independently of you
 
 ### Class-Based Task
 
-Subclass `Task` and implement the `run(self, context)` method:
+Subclass `Task` and implement the `run(self, context)` method. You can set the schedule using **class-level attributes** or by passing parameters to `__init__`:
+
+**Class-level attributes (recommended for simple tasks):**
+
+```python
+from investing_algorithm_framework import Task, TimeUnit
+
+class LogOpenTrades(Task):
+    time_unit = TimeUnit.MINUTE
+    interval = 15
+
+    def run(self, context):
+        for trade in context.get_open_trades():
+            print(f"[{trade.target_symbol}] net_gain={trade.net_gain}")
+```
+
+**Constructor parameters:**
 
 ```python
 from investing_algorithm_framework import Task, TimeUnit
@@ -41,6 +57,8 @@ class PortfolioLoggerTask(Task):
         print(f"Currently {len(open_trades)} open trades")
 ```
 
+Both approaches are equivalent. Class-level attributes are simpler when the schedule is fixed; constructor parameters are useful when you need dynamic configuration.
+
 ### Decorator-Based Task
 
 Use `@app.task()` to turn any function into a task:

docusaurus/docusaurus.config.js

@@ -1,8 +1,9 @@
 // @ts-check
 // Note: type annotations allow type checking and IDEs autocompletion
 
-const lightCodeTheme = require('prism-react-renderer/themes/github');
-const darkCodeTheme = require('prism-react-renderer/themes/dracula');
+const {themes} = require('prism-react-renderer');
+const lightCodeTheme = themes.github;
+const darkCodeTheme = themes.dracula;
 
 /** @type {import('@docusaurus/types').Config} */
 const config = {

docusaurus/sidebar.js

@@ -61,11 +61,11 @@ const sidebars = {
                 },
                 {
                     type: 'doc',
-                    id: 'Data/market-data-sources',
+                    id: 'Data/data-sources',
                 },
                 {
                     type: 'doc',
-                    id: 'Data/multiple-market-data-sources',
+                    id: 'Data/backtest_data',
                 },
             ],
         },

show_docs.sh

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+set -e
+
+cd "$(dirname "$0")/docusaurus"
+
+if [ ! -d "node_modules" ]; then
+    echo "Installing dependencies..."
+    npm install
+fi
+
+if [ "$1" = "--build" ] || [ "$1" = "-b" ]; then
+    echo "Building docs..."
+    npm run build
+    echo "Serving built docs..."
+    npm run serve
+else
+    echo "Starting Docusaurus dev server..."
+    npm start
+fi