Skip to content
6 changes: 4 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,15 +11,17 @@ Official TypeScript-generated documentation for the experimental [Scarp Programm

**Compiler:** https://github.com/scarp-lang/scarp

**Latest published compiler:** [v0.0.6-alpha.2](https://github.com/scarp-lang/scarp/releases/tag/v0.0.6-alpha.2), November 6, 2026, tagged source `398b8ff705154a02423fe458ce3a427401e81e31`. Read the [English release guide](docs/releases/v0.0.6-alpha.2.md) and [हिन्दी विवरण](docs/hi/releases/v0.0.6-alpha.2.md). This release adds opt-in Rust embedding caches and invalidation, **not new Scarp commands**.
**Latest published compiler:** [v0.0.6-alpha.3](https://github.com/scarp-lang/scarp/releases/tag/v0.0.6-alpha.3), November 7, 2026, tagged source `ceff07d9014f466974e0c9e02fc5d23573f55777`. Read the [English release guide](docs/releases/v0.0.6-alpha.3.md) and [हिन्दी विवरण](docs/hi/releases/v0.0.6-alpha.3.md). It ships Top-K and temperature-aware softmax, **not a general native compiler**.

**Previous published compiler:** [v0.0.6-alpha.2](https://github.com/scarp-lang/scarp/releases/tag/v0.0.6-alpha.2), November 6, 2026, tagged source `398b8ff705154a02423fe458ce3a427401e81e31`. Its [English release notes](docs/releases/v0.0.6-alpha.2.md) and [हिन्दी विवरण](docs/hi/releases/v0.0.6-alpha.2.md) cover optional Rust caching.

**Earlier published compiler:** [v0.0.6-alpha.1](https://github.com/scarp-lang/scarp/releases/tag/v0.0.6-alpha.1), November 5, 2026, source commit `aa329a22cf2bf92d2c9814a26ff9c8b67a72e6e8`. Read the [English release guide](docs/releases/v0.0.6-alpha.1.md) and [हिन्दी release guide](docs/hi/releases/v0.0.6-alpha.1.md). The [symbol navigation and CLI reference](docs/tooling/cli-alpha6.md), [हिन्दी symbols guide](docs/hi/tooling/cli-alpha6.md), [RMS tutorial](docs/language/rms-alpha6.md) and [हिन्दी RMS पाठ](docs/hi/language/rms-alpha6.md) document features **actually published** in alpha.6. The docs pin tagged compiler examples/JSON fixtures, track release drift and run the tagged CLI in CI. Native `.srp` compilation and LSP integrations remain unavailable.

**Find documentation in your language:** [Search and navigation](docs/guide/search-and-navigation.md) · [हिन्दी में खोजें](docs/hi/guide/search-and-navigation.md). The Scarp-owned local search offers Hindi labels, accessible keyboard hints and a translated no-results state; English remains unchanged. Search is client-side and does not depend on an external hosted search provider.

**Start learning in order:** [English: seven-stage learning path](docs/guide/learning-path.md) · [हिन्दी: सात चरणों में Scarp](docs/hi/guide/learning-path.md). Historical compiler examples retain their versioned baselines; the learning path explains which release to use, from alpha.1 through the latest alpha.6, without claiming universal compatibility.

**Install the latest published compiler:** [Published alpha.2 archives and checksum guide](docs/releases/v0.0.6-alpha.2.md). Historical [English alpha.1 installation guide](docs/guide/installation-alpha6.md) · [हिन्दी: alpha.6 इंस्टॉलेशन](docs/hi/guide/installation-alpha6.md). Windows x64, Linux x64 GNU, and Apple Silicon archives are paired with official SHA-256 checksums; the guides also provide commands for building the immutable source tag. Earlier installation walkthroughs remain historically scoped.
**Install the latest published compiler:** [Published alpha.3 archives and checksum guide](docs/releases/v0.0.6-alpha.3.md). Historical [English alpha.1 installation guide](docs/guide/installation-alpha6.md) · [हिन्दी: alpha.6 इंस्टॉलेशन](docs/hi/guide/installation-alpha6.md). Windows x64, Linux x64 GNU, and Apple Silicon archives are paired with official SHA-256 checksums; the guides also provide commands for building the immutable source tag. Earlier installation walkthroughs remain historically scoped.

**Automated accessibility auditing:** The extracted offline site is checked with pinned local axe-core in 10 bilingual light/dark/search/mobile states; CI attaches per-state WCAG A/AA findings on failures. Manual screen-reader verification remains separately tracked in [Issue #65](https://github.com/scarp-lang/scarp-docs/issues/65).

Expand Down
4 changes: 2 additions & 2 deletions SCARP-DOCS-ENGINE.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ The engine's test build is generated under artifacts/scarp-engine-preview/scarp-

## Acceptance gates for replacing production

1. **140 pages**: preserve all 70 English and 70 Hindi source routes, local links, home features, heading anchors, code samples, callouts and both embedded interactive widgets.
1. **142 pages**: preserve at least 71 English and 71 Hindi source routes; new paired release pages may increase the count, local links, home features, heading anchors, code samples, callouts and both embedded interactive widgets.
2. **Search and releases**: use a full local index with no external provider; verify correct pinned compiler versions and do not invent unshipped commands.
3. **Accessible UI**: test keyboard, focus return, language switching, appearance persistence, 320px reflow, mobile navigation and code/table scrolling. Run axe WCAG A/AA on representative states. Automated tests are not manual screen-reader certification; see Issue #65.
4. **Deploy and offline**: change production build, archive generation, Pages upload, sitemap/live smoke and downloaded offline browser checks together. Confirm complete URL continuity.
Expand All @@ -43,6 +43,6 @@ The engine's test build is generated under artifacts/scarp-engine-preview/scarp-

## Content security and provenance

The renderer escapes unreviewed raw Markdown HTML. It explicitly recognizes only the project's callouts and named widgets; future embedded content must be implemented and tested rather than bypassing HTML safety. The core language reference remains pinned to v0.0.5-alpha.1. The published compiler at migration start was v0.0.6-alpha.1; v0.0.6-alpha.2 was published November 6, 2026. Neither is the changing compiler main branch.
The renderer escapes unreviewed raw Markdown HTML. It explicitly recognizes only the project's callouts and named widgets; future embedded content must be implemented and tested rather than bypassing HTML safety. The core language reference remains pinned to v0.0.5-alpha.1. The published compiler at migration start was v0.0.6-alpha.1; v0.0.6-alpha.2 was published November 6, 2026; v0.0.6-alpha.3 followed November 7 with Top-K and temperature softmax. These are pinned published tags, not the moving compiler main branch.

The Scarp-owned renderer is now the production-build candidate. The VitePress and vue-tsc npm dependencies have been removed; old theme/config source fixtures and some evidence checks remain temporarily to protect compiler and bilingual regression coverage. None of these remaining files render or serve Pages. Remove them after live Pages, offline archive, and release CI have independently confirmed the new output. Track completion in Issue #70.
12 changes: 6 additions & 6 deletions data/compiler-latest-release.json
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
{
"compilerRepository": "scarp-lang/scarp",
"compilerRef": "v0.0.6-alpha.2",
"compilerCommit": "398b8ff705154a02423fe458ce3a427401e81e31",
"releasedAt": "2026-11-06T11:03:46Z",
"compilerRef": "v0.0.6-alpha.3",
"compilerCommit": "ceff07d9014f466974e0c9e02fc5d23573f55777",
"releasedAt": "2026-11-07T12:23:26Z",
"status": "published-prerelease",
"historicalReferenceBaseline": "v0.0.5-alpha.1",
"assets": [
"scarp-0.0.6-alpha.2-x86_64-pc-windows-msvc.zip",
"scarp-0.0.6-alpha.2-x86_64-unknown-linux-gnu.tar.gz",
"scarp-0.0.6-alpha.2-aarch64-apple-darwin.tar.gz",
"scarp-0.0.6-alpha.3-x86_64-pc-windows-msvc.zip",
"scarp-0.0.6-alpha.3-x86_64-unknown-linux-gnu.tar.gz",
"scarp-0.0.6-alpha.3-aarch64-apple-darwin.tar.gz",
"SHA256SUMS"
]
}
2 changes: 1 addition & 1 deletion docs/guide/installation-alpha6.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

This is a **historical, version-pinned Scarp compiler prerelease**, [v0.0.6-alpha.1](https://github.com/scarp-lang/scarp/releases/tag/v0.0.6-alpha.1) (November 5, 2026), built from exact source commit `aa329a22cf2bf92d2c9814a26ff9c8b67a72e6e8`. Scarp is an **experimental interpreter**, not a stable package manager or a compiler that turns `.srp` programs into native executables.

**For the latest published v0.0.6-alpha.2 packages and checksums, use the [new release guide](/releases/v0.0.6-alpha.2).** The archive names, hashes and exact source commit below intentionally refer to **alpha.1**, and must not be mixed with alpha.2 artifacts.
**For the latest published v0.0.6-alpha.3 packages and checksums, use the [new release guide](/releases/v0.0.6-alpha.3).** The archive names, hashes and exact source commit below intentionally refer to **alpha.1**, and must not be mixed with alpha.2 artifacts.

The release provides read-only [symbol and reference inspection](/tooling/cli-alpha6), [RMS numerics](/language/rms-alpha6), and a [complete two-file project tutorial](/tutorials/project-symbol-navigation-alpha6).

Expand Down
4 changes: 2 additions & 2 deletions docs/guide/introduction.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# Introduction to Scarp

**Latest published compiler: [v0.0.6-alpha.2](https://github.com/scarp-lang/scarp/releases/tag/v0.0.6-alpha.2).** This release adds optional Rust embedding caches, not new CLI commands; see the [release guide](/releases/v0.0.6-alpha.2). For new learners start with the [seven-stage learning path](/guide/learning-path) and the [latest alpha.6 release assets and checksums](/releases/v0.0.6-alpha.1); then follow the complete [alpha.6 project lab](/tutorials/project-symbol-navigation-alpha6).
**Latest published compiler: [v0.0.6-alpha.3](https://github.com/scarp-lang/scarp/releases/tag/v0.0.6-alpha.3).** This experimental release adds deterministic Top-K ranking and temperature softmax, not general native compilation; see the [release guide](/releases/v0.0.6-alpha.3). New learners can start with the [seven-stage learning path](/guide/learning-path); the [alpha.1 installation instructions](/guide/installation-alpha6) and [alpha.6 project lab](/tutorials/project-symbol-navigation-alpha6) remain pinned to their original release.

Scarp is an **experimental**, Rust-implemented, interpreted programming language. The **previous published compiler** is [v0.0.5-alpha.5](https://github.com/scarp-lang/scarp/releases/tag/v0.0.5-alpha.5). This general-language overview remains based on the separately verified **alpha.1 reference**; the historical [alpha.4 tagged release](https://github.com/scarp-lang/scarp/releases/tag/v0.0.5-alpha.4), [alpha.4 installation](/guide/installation), [alpha.4 project quickstart](/guide/quickstart-alpha4), and [alpha.3 CLI reference](/tooling/cli) remain historical version-scoped guides. The language is not yet a stable general-purpose alternative to Rust, C++, or Python.
Scarp is an **experimental**, Rust-implemented, interpreted programming language. An **earlier published compiler** is [v0.0.5-alpha.5](https://github.com/scarp-lang/scarp/releases/tag/v0.0.5-alpha.5). This general-language overview remains based on the separately verified **alpha.1 reference**; the historical [alpha.4 tagged release](https://github.com/scarp-lang/scarp/releases/tag/v0.0.5-alpha.4), [alpha.4 installation](/guide/installation), [alpha.4 project quickstart](/guide/quickstart-alpha4), and [alpha.3 CLI reference](/tooling/cli) remain historical version-scoped guides. The language is not yet a stable general-purpose alternative to Rust, C++, or Python.

Scarp uses UTF-8 `.srp` source files, a lexer, a parser, a resolver, and an interpreter. Its implementation emphasizes checked numerical operations, explicit output, bounded evaluation, and increasingly capable numerical utilities. The compiler repository contains runnable `.srp` examples and expected-output fixtures.

Expand Down
2 changes: 1 addition & 1 deletion docs/guide/learning-path.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

**Unsure which command belongs to your installed compiler?** Use the [interactive version-aware CLI Command Finder](/tooling/command-finder) to avoid mixing older `run` / `check` with newer static `verify` or project inspection.

**Current compiler:** The newest published prerelease is [v0.0.6-alpha.2](/releases/v0.0.6-alpha.2), which adds optional Rust caching APIs, not new Scarp syntax or CLI commands. The alpha.1 symbol-navigation lesson below remains tied to its original checked examples.
**Current compiler:** The newest published prerelease is [v0.0.6-alpha.3](/releases/v0.0.6-alpha.3), with Top-K ranking and temperature softmax, but no new CLI commands or general native compiler. The alpha.1 symbol-navigation lesson below remains tied to its original checked examples.

**Start here if you are new to Scarp.** This track connects complete, compiler-backed lessons from the first program through numerical modeling, project modules, and the symbol-navigation tools introduced in the **[published v0.0.6-alpha.1](https://github.com/scarp-lang/scarp/releases/tag/v0.0.6-alpha.1)** prerelease.

Expand Down
2 changes: 1 addition & 1 deletion docs/guide/quickstart-alpha3.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

<!-- scarp-cli-release: v0.0.5-alpha.3 -->

This is the **historically verified alpha.3 first-run guide**, [v0.0.5-alpha.3](https://github.com/scarp-lang/scarp/releases/tag/v0.0.5-alpha.3), published **November 2, 2026**. Scarp is experimental and runs programs through an interpreter: there is **no native executable builder or stable language guarantee**. Older reference pages remain pinned to [alpha.1](/reference/status). **For a new installation, see the [current v0.0.6-alpha.2 release](/releases/v0.0.6-alpha.2); the commands and files below are intentionally pinned to alpha.3.**
This is the **historically verified alpha.3 first-run guide**, [v0.0.5-alpha.3](https://github.com/scarp-lang/scarp/releases/tag/v0.0.5-alpha.3), published **November 2, 2026**. Scarp is experimental and runs programs through an interpreter: there is **no native executable builder or stable language guarantee**. Older reference pages remain pinned to [alpha.1](/reference/status). **For a new installation, see the [current v0.0.6-alpha.3 release](/releases/v0.0.6-alpha.3); the commands and files below are intentionally pinned to alpha.3.**

## 1. Choose and verify the official download

Expand Down
2 changes: 1 addition & 1 deletion docs/guide/quickstart-alpha4.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Quickstart: your first Scarp project (v0.0.5-alpha.4)
::: tip Latest published compiler
New installs should use the [published v0.0.6-alpha.2 release and checksums](/releases/v0.0.6-alpha.2) and [release-aware learning path](/guide/learning-path). This alpha.4 page is intentionally pinned to its original generator, binary and stdout.
New installs should use the [published v0.0.6-alpha.3 release and checksums](/releases/v0.0.6-alpha.3) and [release-aware learning path](/guide/learning-path). This alpha.4 page is intentionally pinned to its original generator, binary and stdout.
:::


Expand Down
2 changes: 1 addition & 1 deletion docs/hi/guide/installation-alpha6.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

यह **पुराने प्रकाशित Scarp compiler prerelease का version-specific guide** [v0.0.6-alpha.1](https://github.com/scarp-lang/scarp/releases/tag/v0.0.6-alpha.1) (5 नवंबर 2026) की installation guide है। इसका सही source commit `aa329a22cf2bf92d2c9814a26ff9c8b67a72e6e8` है। Scarp अभी **प्रयोगात्मक interpreter** है, न कि stable package manager या `.srp` को native executable में बदलने वाला compiler।

**नवीनतम प्रकाशित v0.0.6-alpha.2 packages और checksum के लिए [नई release guide](/hi/releases/v0.0.6-alpha.2) पढ़ें।** नीचे के archive नाम, hash और source commit जानबूझकर पुराने **alpha.1** के हैं; इन्हें alpha.2 की files से न मिलाएँ।
**नवीनतम प्रकाशित v0.0.6-alpha.3 packages और checksum के लिए [नई release guide](/hi/releases/v0.0.6-alpha.3) पढ़ें।** नीचे के archive नाम, hash और source commit जानबूझकर पुराने **alpha.1** के हैं; इन्हें alpha.2 की files से न मिलाएँ।

इस संस्करण में [symbols और references की static जाँच](/hi/tooling/cli-alpha6), [RMS गणना](/hi/language/rms-alpha6), और [दो source files वाला पूरा project tutorial](/hi/tutorials/project-symbol-navigation-alpha6) उपलब्ध हैं।

Expand Down
Loading
Loading