erick-alcachofa 8f15650a42
docs: add comprehensive language overview and syntax example
Signed-off-by: erick-alcachofa <erick@artichoke.dev>

Introduces 'docs/example.arti' as an exhaustive showcase of the
`artichoke` programming language syntax and grammar.

This file serves as a technical specification and "living documentation"
for the language.

Key features demonstrated include:

- Module imports and symbol aliasing (using).
- Generic definitions vs. Turbofish (::<>) instantiations.
- Designated initializers (.field = expr) and member functions (this).
- Tagged enums and explicit error handling via Result<T, E>.
- Pointer (*), mutability ($), and optional (?) type qualifiers.
- Slice syntax, array literals, and specialized suffixes (.*, .#, .[]).
- Advanced control flow: Result/Optional unwrapping (|val|) and labeled
  loops.
- Compile-time reflection using the .@ operator.
2025-12-28 13:43:51 -06:00
..
2025-10-02 00:26:35 -06:00