"extensions": [
-        "DavidAnson.vscode-markdownlint",
         "ms-dotnettools.csdevkit",
         "DotJoshJohnson.xml",
         "redhat.vscode-yaml",
         "bierner.github-markdown-preview",
         "EditorConfig.EditorConfig",
-        "ms-dotnettools.vscodeintellicode-csharp"
-        "DavidAnson.vscode-markdownlint",
+        "ms-dotnettools.vscodeintellicode-csharp",
+        "DavidAnson.vscode-markdownlint",
         "GitHub.copilot-chat"
       ]

-# Navigate to the workspace root
-cd /workspaces/Stock.Indicators
+# Navigate to the repository root robustly
+REPO_ROOT="$(git rev-parse --show-toplevel 2>/dev/null)" || {
+  echo -e "${YELLOW}WARNING: Unable to determine repo root; falling back to script dir${NC}"
+  REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+}
+cd "$REPO_ROOT" || {
+  echo -e "${YELLOW}WARNING: Failed to cd to repository root${NC}"
+  exit 1
+}

 # Install MkDocs
- pip install mkdocs || echo -e "${YELLOW}WARNING: Failed to install MkDocs${NC}"
+ python -m pip install --upgrade -r docs/requirements.txt \
+   || echo -e "${YELLOW}WARNING: Failed to install MkDocs requirements${NC}"

-# Build MkDocs documentation
-cd docs && python -m mkdocs build || echo -e "${YELLOW}WARNING: Failed to build MkDocs documentation${NC}"
-
-# Build the project
-cd .. && dotnet build --no-incremental || echo -e "${YELLOW}WARNING: Failed to build the project${NC}"
+ # Build MkDocs documentation
+ pushd docs >/dev/null || { echo -e "${YELLOW}WARNING: docs/ not found${NC}"; }
+ python -m mkdocs build || echo -e "${YELLOW}WARNING: Failed to build MkDocs documentation${NC}"
+ popd >/dev/null 2>&1 || true
+
+ # Build the project
+ dotnet build --no-incremental || echo -e "${YELLOW}WARNING: Failed to build the project${NC}"

 #!/bin/bash

-# Build the MkDocs site
-echo "Building MkDocs site..."
-cd /workspaces/Stock.Indicators/docs
-mkdocs build
+set -Eeuo pipefail
+
+# Build the MkDocs site
+echo "Building MkDocs site..."
+# change to the directory where this script resides (docs/)
+SCRIPT_DIR="$(cd -- "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+cd "$SCRIPT_DIR" || exit 1
+mkdocs build

-echo "MkDocs site built successfully! Files are in /docs/_site/"
+echo "MkDocs site built successfully! Files are in ./site/"

- Pivots is an extended customizable version of Williams Fractal that includes identification of Higher High, Lower Low, Higher Low, and Lower Low trends between pivots in a lookback window.
+ 

-Pivots is an extended customizable version of [Williams Fractal](Fractal.md) that includes identification of Higher High, Lower Low, Higher Low, and Lower Low trends between pivots in a lookback window.
+Pivots is an extended customizable version of [Williams Fractal](Fractal.md) that includes identification of Higher High, Lower High, Higher Low, and Lower Low trends between pivots in a lookback window.

- Created by Carl Swenlin, the DecisionPoint Price Momentum Oscillator is double-smoothed momentum indicator, based on Rate of Change (ROC).
-
-
-
-Created by Carl Swenlin, the DecisionPoint [Price Momentum Oscillator](https://school.stockcharts.com/doku.php?id=technical_indicators:dppmo) is double-smoothed momentum indicator based on Rate of Change (ROC).
+Created by Carl Swenlin, the DecisionPoint [Price Momentum Oscillator](https://school.stockcharts.com/doku.php?id=technical_indicators:dppmo) is a double-smoothed momentum indicator based on Rate of Change (ROC).

-![chart for Pvo](../assets/charts/Pvo.png)
+![Percentage Volume Oscillator (PVO) example chart](../assets/charts/Pvo.png)

-![image](../assets/charts/Linear.png)
-![image](../assets/charts/Slope.png)
+![Linear regression best-fit line example (Linear)](../assets/charts/Linear.png)
+![Slope indicator values over time (Slope)](../assets/charts/Slope.png)

-      - CFO: indicators/Fcb.md
+      - CFO: indicators/Cfo.md

-            // report results
-            decimal netReturn = (totalEquityValue - totalEquityCost) / totalEquityCost;
-
-            Console.WriteLine($"\r\nSTRATEGY RESULTS:");
-            Console.WriteLine($"trades: {totalTrades}");
-            Console.WriteLine($"net return: {netReturn:P2}");
+            // report results
+            Console.WriteLine($"\r\nSTRATEGY RESULTS:");
+            Console.WriteLine($"trades: {totalTrades}");
+            if (totalEquityCost == 0m)
+            {
+                Console.WriteLine("net return: N/A (no closed positions)");
+            }
+            else
+            {
+                decimal netReturn = (totalEquityValue - totalEquityCost) / totalEquityCost;
+                Console.WriteLine($"net return: {netReturn:P2}");
+            }

-var rsiQuotes = rsiResults
-                 .Select(x => 
-                    new Quote
-                    {
-                        Date = x.Date,
-                        Close = x.Rsi
-                    });
+var rsiQuotes = rsiResults.Select(x =>
+    new Quote
+    {
+        Date = x.Date,
+        Open = x.Rsi,
+        High = x.Rsi,
+        Low = x.Rsi,
+        Close = x.Rsi,
+        Volume = 0
+    });

- ![chart for Adx](../assets/charts/AdIndex.png)
+ ![chart for ADX](../assets/charts/Adx.png)

- Created by Bill Williams, Alligator is a depiction of three smoothed moving averages of median price, showing chart patterns that compared to an alligator's feeding habits when describing market movement. The moving averages are known as the Jaw, Teeth, and Lips, which are calculated using lookback and offset periods.  The related Gator Oscillator depicts periods of eating and resting.
-
-
-
-Created by Bill Williams, Alligator is a depiction of three smoothed moving averages of median price, showing chart patterns that compared to an alligator's feeding habits when describing market movement. The moving averages are known as the Jaw, Teeth, and Lips, which are calculated using lookback and offset periods.  See also the [Gator Oscillator](Gator.md).
+Created by Bill Williams, Alligator is a depiction of three smoothed moving averages of median price, showing chart patterns compared to an alligator's feeding habits when describing market movement. The moving averages are known as the Jaw, Teeth, and Lips, which are calculated using lookback and offset periods. See also the [Gator Oscillator](Gator.md).

-  Moving Average Envelopes is a price band channel overlay that is offset from the moving average of price.
-
-
-
-[Moving Average Envelopes](https://en.wikipedia.org/wiki/Moving_average_envelope) is a price band channel overlay that is offset from the moving average of price.
+[Moving Average Envelopes](https://en.wikipedia.org/wiki/Moving_average_envelope) is a price band channel overlay offset from the moving average of price.

-You must have at least `N` periods of `quotesEval` to calculate `PrsPercent` if `lookbackPeriods` is specified; otherwise, you must specify at least `S+1` periods.  More than the minimum is typically specified.  For this indicator, the elements must match (e.g. the `n`th elements must be the same date).  An `Exception` will be thrown for mismatch dates.  Historical price quotes should have a consistent frequency (day, hour, minute, etc).
-
-`quotesEval` is an `IEnumerable<TQuote>` collection of historical price quotes.  It should have a consistent frequency (day, hour, minute, etc).  See [the Guide](../guide.md#historical-quotes) for more information.
+You must have at least `N` periods of `quotesEval` to calculate `PrsPercent` if `lookbackPeriods` is specified; otherwise, there is no additional minimum beyond having matching elements between the series.  More than the minimum is typically specified.  For this indicator, the elements must match (e.g., the `n`th elements must be the same date).  An `Exception` will be thrown for mismatched dates.  Historical price quotes should have a consistent frequency (day, hour, minute, etc.).
+
+`quotesEval` is an `IEnumerable<TQuote>` collection of historical price quotes.  It should have a consistent frequency (day, hour, minute, etc.).  See [the Guide](../guide.md#historical-quotes) for more information.

- 
- Rate of Change, also known as Momentum Oscillator, is the percent change of price over a lookback window.  Momentum is the raw price change equivalent.
-
-
-
-
 [Rate of Change](https://en.wikipedia.org/wiki/Momentum_(technical_analysis)), also known as Momentum Oscillator, is the percent change of price over a lookback window.  Momentum is the raw price change equivalent.  A [Rate of Change with Bands](RocWb.md) variant, created by Vitali Apirine, is also available.
 [[Discuss] 💬](https://github.com/DaveSkender/Stock.Indicators/discussions/242 "Community discussion about this indicator")

- Created by J. Welles Wilder, the Relative Strength Index is an oscillator that measures strength of the winning/losing price streak on a scale of 0 to 100, to depict overbought and oversold conditions.
-
-
-
-Created by J. Welles Wilder, the [Relative Strength Index](https://en.wikipedia.org/wiki/Relative_strength_index) is an oscillator that measures strength of the winning/losing streak over `N` lookback periods on a scale of 0 to 100, to depict overbought and oversold conditions.
+Created by J. Welles Wilder, the [Relative Strength Index](https://en.wikipedia.org/wiki/Relative_strength_index) is an oscillator that measures the strength of winning/losing streaks over `N` lookback periods on a 0–100 scale to depict overbought and oversold conditions.