Normalize script names; enforce numeric ordering, restore missing chapters, and strip embedded non‑ToC links

[samuelymh]

This commit refines the existing PineScript docs pipeline by renaming scripts for consistent numeric ordering and updating the processing logic so outputs are deterministic and readable.

Key changes

• Renamed/normalized script filenames to a numeric ordering convention (e.g., 1_scrap_docs.py, 2_process_docs.py, 3_scrap_and_process.py) to make the processing order explicit.
• Changed processing logic so scraped source files and processed outputs are sorted and handled numerically. This guarantees the final combined file (processed_all_docs.md) contains chapters in the intended order.
• Fixed an issue where some chapters were skipped when pages lacked enough content; processing now includes these chapters reliably.
• Removed embedded links that were not part of the Table of Contents from the main content so processed Markdown focuses on content, not inline navigation links.
• Updated README.md (if required) and committed updated processed outputs under pinescript_docs as a snapshot for review.

Why this matters

• Deterministic ordering makes reviews and diffs meaningful and prevents content reordering noise in future runs.
• Restoring missing chapters prevents incomplete documentation when source pages have sparse content.
• Stripping non-ToC embedded links improves readability of the processed documentation and reduces spurious inline link noise for downstream tooling.

How to verify (copy/paste friendly)

1. Install deps and run the pipeline (zsh):

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python 3_scrap_and_process.py

2. Confirm ordering:

• Open processed and verify files are named/ordered numerically (e.g., processed_1_*.md, processed_2_*.md, ...).
• Open processed_all_docs.md and confirm chapters appear in numeric order.

3. Confirm missing chapters are present:

• Compare prior snapshot (if available) and spot-check earlier-missing chapters are now included.

4. Confirm embedded links removal:

• In a few processed files and processed_all_docs.md, search for anchor-style in-content links that are not part of the ToC (e.g., inline See section links) and verify they are removed.

Notes for reviewers

• Focus on the processing changes that implement numeric sorting and the logic that detects/keeps low-content pages.
• Check that legitimate inline links (e.g., links inside code examples or references) are preserved, while non-ToC navigation links are removed.
• Consider whether the numeric naming should be a formal CLI option or configurable in a follow-up.

Suggested labels & milestone

• Labels: enhancement, docs, cleanup
• Milestone: docs-improvements

Changelog (one-liner)
Normalize script names and processing order; restore missing chapters and remove non‑ToC embedded links for cleaner processed docs.