Moved all docs from ./docs/ to ./web/documentation/ to be available on the website. No code changes. (0.40.5)

web/documentation/errors-and-diagnostics.md

@@ -0,0 +1,47 @@
+---
+layout: page
+published: true
+noToc: true
+noComments: false
+noDate: false
+title: Fun - Errors and Diagnostics
+subtitle: Understanding parser/runtime errors and enabling diagnostics.
+description: Understanding parser/runtime errors and enabling diagnostics.
+permalink: /documentation/errors-and-diagnostics/
+lang: en
+tags:
+- documentation
+- handbook
+- installation
+- usage
+- introduction
+- help
+- guide
+- howto
+- docs
+- specifications
+- specs
+- repl
+---
+
+# Errors and Diagnostics
+
+This guide helps you understand common error messages and how to collect useful diagnostics.
+
+## Common error classes
+- Parse errors: syntax/indentation problems detected before execution.
+- Name/lookup errors: missing variables, functions, or modules.
+- Runtime errors: type mismatches, out-of-range access, invalid operations.
+
+## Enabling diagnostics
+- Build with `-DFUN_DEBUG=ON` to enable additional assertions and debug messages (see [build.md](./build/)).
+- Run with smaller, focused scripts to isolate issues.
+
+## Getting useful reports
+- Capture the minimal script that reproduces the issue.
+- Note your build options and platform.
+- Record the full error output from the CLI (`fun`), including line/column if present.
+
+## Tips
+- Use prints or logging sparingly to narrow down failing code.
+- Start from a passing simple case and add complexity until it breaks.