Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion docs/guide/installation-alpha6.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,9 @@
<!-- scarp-install-release: v0.0.6-alpha.1 -->
<!-- scarp-install-compiler: aa329a22cf2bf92d2c9814a26ff9c8b67a72e6e8 -->

This is the **current published 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.
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.

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
2 changes: 2 additions & 0 deletions docs/guide/learning-path.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@

**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.

**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.

Scarp is experimental. There is **no single compiler version guaranteed to run every example from every historical guide**. Each stage names the release used to verify its examples. Read the language concept in order, but **run a sample only with the release named by that lesson**, or test it yourself with another compiler. The general language reference remains pinned to v0.0.5-alpha.1; newer guides are separate release-specific evidence.
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 **recommended first-run guide for the latest published prerelease**, [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).
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.**

## 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.1 release and checksums](/releases/v0.0.6-alpha.1) 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.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.
:::


Expand Down
4 changes: 3 additions & 1 deletion docs/hi/guide/installation-alpha6.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,9 @@
<!-- scarp-install-release: v0.0.6-alpha.1 -->
<!-- scarp-install-compiler: aa329a22cf2bf92d2c9814a26ff9c8b67a72e6e8 -->

यह **वर्तमान प्रकाशित Scarp compiler prerelease** [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।
यह **पुराने प्रकाशित 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 से न मिलाएँ।

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

Expand Down
2 changes: 2 additions & 0 deletions docs/hi/guide/learning-path.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@

**आपके compiler में कौन सा command उपलब्ध है?** [Version-aware CLI Command Finder](/hi/tooling/command-finder) में installed release और काम चुनें। पुरानी `run` / `check` commands को नए static `verify` या project inspection से न मिलाएँ।

**नवीनतम compiler:** प्रकाशित [v0.0.6-alpha.2](/hi/releases/v0.0.6-alpha.2) में वैकल्पिक Rust caching APIs आई हैं, नया Scarp syntax या CLI command नहीं। नीचे का alpha.1 symbol-navigation पाठ अपने मूल परीक्षण किए हुए examples पर आधारित है।

**Scarp पहली बार सीख रहे हैं तो यहाँ से शुरुआत करें।** यह मार्गदर्शिका शुरुआती प्रोग्राम से numerical examples, source modules, project और **[प्रकाशित v0.0.6-alpha.1](https://github.com/scarp-lang/scarp/releases/tag/v0.0.6-alpha.1)** में आए symbol-navigation tools तक पहुँचाती है। हर पाठ के examples compiler के वास्तविक परीक्षणों पर आधारित हैं।

Scarp अभी **experimental prerelease** है। ऐसा **कोई प्रमाण नहीं** कि हर पुराने tutorial का code एक ही नए binary में बिना बदलाव चलेगा। इसलिए **पढ़ाई इसी क्रम में करें**, लेकिन code चलाते समय **उस tutorial का बताया हुआ exact release** प्रयोग करें या दूसरे release पर स्वयं जाँचें। मुख्य भाषा-संदर्भ अभी v0.0.5-alpha.1 से सत्यापित है; नए features अलग release-specific पाठ में लिखे हैं।
Expand Down
2 changes: 1 addition & 1 deletion docs/hi/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 -->

यह **नई प्रकाशित prerelease** [v0.0.5-alpha.3](https://github.com/scarp-lang/scarp/releases/tag/v0.0.5-alpha.3) (2 नवंबर 2026) के लिए शुरुआती मार्गदर्शिका है। Scarp अभी **प्रयोगात्मक interpreter** है। यह `.srp` से native executable नहीं बनाता और भाषा की स्थिर compatibility की गारंटी नहीं है। पुराने मुख्य संदर्भ का आधार अब भी [alpha.1](/hi/reference/status) है।
यह **ऐतिहासिक, alpha.3 के लिए सत्यापित शुरुआती गाइड** [v0.0.5-alpha.3](https://github.com/scarp-lang/scarp/releases/tag/v0.0.5-alpha.3) (2 नवंबर 2026) के लिए शुरुआती मार्गदर्शिका है। Scarp अभी **प्रयोगात्मक interpreter** है। यह `.srp` से native executable नहीं बनाता और भाषा की स्थिर compatibility की गारंटी नहीं है। पुराने मुख्य संदर्भ का आधार अब भी [alpha.1](/hi/reference/status) है। **नई स्थापना के लिए [वर्तमान v0.0.6-alpha.2 release](/hi/releases/v0.0.6-alpha.2) देखें; नीचे के commands और source examples जानबूझकर alpha.3 पर आधारित हैं।**

## 1. सही archive चुनें और checksum मिलाएँ

Expand Down
2 changes: 1 addition & 1 deletion docs/hi/guide/quickstart-alpha4.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Scarp में पहला project बनाएँ (v0.0.5-alpha.4)
::: tip नवीनतम प्रकाशित compiler
नए उपयोगकर्ताओं के लिए [प्रकाशित v0.0.6-alpha.1 release और checksum](/hi/releases/v0.0.6-alpha.1) तथा [सही version वाला learning path](/hi/guide/learning-path) हैं। इस पुराने alpha.4 guide का source, binary और stdout जानबूझकर बदला नहीं गया है।
नए उपयोगकर्ताओं के लिए [प्रकाशित v0.0.6-alpha.2 release और checksum](/hi/releases/v0.0.6-alpha.2) तथा [सही version वाला learning path](/hi/guide/learning-path) हैं। इस पुराने alpha.4 guide का source, binary और stdout जानबूझकर बदला नहीं गया है।
:::


Expand Down
2 changes: 1 addition & 1 deletion docs/hi/language/typed-bindings-alpha2.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
इस पाठ में 2 नवंबर 2026 को प्रकाशित **[v0.0.5-alpha.2](https://github.com/scarp-lang/scarp/releases/tag/v0.0.5-alpha.2)** की दो वास्तविक सुविधाएँ सीखेंगे: `bind` / `var` में स्पष्ट type annotation और जाँच के साथ numeric conversion। Source का सटीक compiler commit [`e4db8e191cd7ea623123cae7348450ca6c95b170`](https://github.com/scarp-lang/scarp/commit/e4db8e191cd7ea623123cae7348450ca6c95b170) है। यह **release-specific** पाठ है। पुराने [variables](/hi/language/variables) और [types](/hi/language/types) के सामान्य references अब भी अलग **alpha.1** प्रमाण पर आधारित हैं।

::: tip कौन-सा संस्करण?
नीचे की commands **alpha.2 compiler** पर ही चलाएँ। सबसे नया प्रकाशित compiler [alpha.3](/hi/releases/v0.0.5-alpha.3) है, जिसमें नए CLI commands भी हैं। Alpha.1 executable इन annotations और conversion functions को नहीं समझता। इस पाठ के पूरे programs वास्तविक **tagged alpha.2 compiler** पर जाँचे गए हैं; सभी versions के लिए compatibility की गारंटी नहीं दी गई है।
नीचे की commands **alpha.2 compiler** पर ही चलाएँ। नवीनतम प्रकाशित compiler [v0.0.6-alpha.2](/hi/releases/v0.0.6-alpha.2) है; पुराने [alpha.3 release](/hi/releases/v0.0.5-alpha.3) में नए CLI commands आए थे। Alpha.1 executable इन annotations और conversion functions को नहीं समझता। इस पाठ के पूरे programs वास्तविक **tagged alpha.2 compiler** पर जाँचे गए हैं; सभी versions के लिए compatibility की गारंटी नहीं दी गई है।
:::

## 1. Type annotation क्या होता है?
Expand Down
11 changes: 8 additions & 3 deletions docs/hi/reference/compatibility.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,8 @@ Scarp के शुरुआती prereleases में syntax और API ब

| संस्करण | प्रमुख प्रकाशित सुविधा |
| --- | --- |
| **`v0.0.6-alpha.1`** | **नवीनतम, 5 नवंबर 2026:** static symbols/references JSON inspection तथा `rms(vector)`; [release](/hi/releases/v0.0.6-alpha.1), [पूरा project lab](/hi/tutorials/project-symbol-navigation-alpha6) |
| **[v0.0.6-alpha.2](/hi/releases/v0.0.6-alpha.2)** | **वर्तमान प्रकाशित prerelease (6 नवंबर):** वैकल्पिक Rust caching और dependency invalidation APIs; नया Scarp CLI command या syntax नहीं |
| **`v0.0.6-alpha.1`** | **पिछला प्रकाशित, 5 नवंबर 2026:** static symbols/references JSON inspection तथा `rms(vector)`; [release](/hi/releases/v0.0.6-alpha.1), [पूरा project lab](/hi/tutorials/project-symbol-navigation-alpha6) |
| **`v0.0.5-alpha.5`** | पिछला, 4 नवंबर 2026: project-directory module inspection; केवल Rust embedding के लिए सीमित C11 emitter; [release](/hi/releases/v0.0.5-alpha.5) |
| **`v0.0.5-alpha.4`** | 3 नवंबर: नया project create, static verify DIRECTORY, launch; [project guide](/hi/releases/v0.0.5-alpha.4) |
| `v0.0.1` | integer arithmetic, शुरुआती printing |
Expand All @@ -33,12 +34,16 @@ Scarp के शुरुआती prereleases में syntax और API ब

पुराने version की syntax की सामान्य compatibility **सिद्ध नहीं** है। पुराने examples को उसी tagged version से जाँचें; version-specific tutorials और manifests को बदलकर नया tag न दें।

## नवीनतम प्रकाशित alpha.6 की compatibility सीमा
## प्रकाशित alpha.6 symbols और CLI की compatibility सीमा

वर्तमान प्रकाशित compiler [v0.0.6-alpha.1](https://github.com/scarp-lang/scarp/releases/tag/v0.0.6-alpha.1) का source commit `aa329a22cf2bf92d2c9814a26ff9c8b67a72e6e8` है। इसमें `scarp inspect symbols --json` तथा `scarp inspect references --json` से file या explicit project directory के definitions/references देख सकते हैं। साथ में `rms(vector)` भी प्रकाशित हुआ है। Symbol IDs केवल **एक compilation snapshot** के लिए हैं; कोई तैयार LSP, rename या incremental cache उपलब्ध नहीं है। [Alpha.6 CLI](/hi/tooling/cli-alpha6), [RMS पाठ](/hi/language/rms-alpha6) और [project lab](/hi/tutorials/project-symbol-navigation-alpha6) पढ़ें।
पहले प्रकाशित alpha.6 compiler [v0.0.6-alpha.1](https://github.com/scarp-lang/scarp/releases/tag/v0.0.6-alpha.1) का source commit `aa329a22cf2bf92d2c9814a26ff9c8b67a72e6e8` है। इसमें `scarp inspect symbols --json` तथा `scarp inspect references --json` से file या explicit project directory के definitions/references देख सकते हैं। साथ में `rms(vector)` भी प्रकाशित हुआ है। Symbol IDs केवल **एक compilation snapshot** के लिए हैं; कोई तैयार LSP, rename या user-facing incremental compilation service नहीं है; बाद के alpha.2 में अलग Rust cache APIs आई हैं। [Alpha.6 CLI](/hi/tooling/cli-alpha6), [RMS पाठ](/hi/language/rms-alpha6) और [project lab](/hi/tutorials/project-symbol-navigation-alpha6) पढ़ें।

[सात चरणों वाला learning path](/hi/guide/learning-path) हर पुराने tutorial के लिए **सही compiler release** बताता है। नए features के आने से सभी पुराने source files के compatible होने का प्रमाण नहीं मिलता। Native `.srp` executable compiler CLI और general tensor runtime अभी नहीं हैं।

## नवीनतम alpha.2 में Rust caching की सीमा

[6 नवंबर की प्रकाशित prerelease](/hi/releases/v0.0.6-alpha.2) में whole-graph resolution, tokens और AST के लिए सीमित, वैकल्पिक Rust cache APIs, dependency invalidation तथा source eviction शामिल हैं। **नया Scarp syntax या CLI command नहीं आया है।** पुराने alpha.1 examples अपने मूल compiler version पर सत्यापित रहते हैं। Cache hit से import, syntax, type और resource checks नहीं छोड़ी जातीं।

## पुराना स्रोत migrate करना

नए source में अपरिवर्तनीय declaration `bind name = expr;`, mutable declaration `var name = expr;` है। पुराने `let`/`let mut` syntax को वर्तमान `bind`/`var` से बदलें। `print` और `println` alias हैं, लेकिन बहुत पुराने binaries इन्हें अलग तरह से समझते थे।
Expand Down
Loading
Loading