This folder is organized into three layers:
- Getting started and comparative docs (
docs/guides/) - Language behavior specifications:
docs/specs/ - Internal structure and component design:
docs/architecture/
- Tutorial:
guides/getting-started-tutorial.md - REPL guide:
guides/repl.md - FScript vs F# / OCaml:
guides/fsharp-ocaml-differences.md - Language rationale:
guides/language-choices.md
The website manual sources separate a guided learning path from lookup material:
- Standard library overview and complete signature index
- Syntax and operators and native types
- CLI, environment configuration, and editor settings/commands
- .NET embedding, JavaScript embedding, and host-provided types
- Specifications index:
specs/README.md - Architecture index:
architecture/README.md
make test includes CLI/DAP integration tests and headless native callbacks.
make vscode-debug-smoke launches an isolated real VS Code Extension Development
Host and checks a breakpoint, locals, a safe watch, and resumption. Set
VSCODE_EXECUTABLE when VS Code is not at the standard macOS location or on PATH.
Linux needs a graphical session or Xvfb. The smoke test creates a temporary
workspace and user-data directory, with fscript.cli.path pointing to the
repository build.
See the debugger specification for the runtime API and execution model.
make benchmark-evaluation measures normal evaluation without a debugger. See the
evaluator benchmark for
workloads and comparisons against a published engine.