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.