# Chi Programming Language Documentation

Welcome to the Chi programming language documentation! Chi is a localized programming language that uses Chichewa keywords and syntax.

## Documentation Files

### Core Language Features
- [**Complete Features Guide**](CHI_LANGUAGE_FEATURES.md) - Comprehensive documentation of all Chi language features
- [Chichewa List Methods](CHICHEWA_LIST_METHODS.md) - Complete guide to list operations in Chichewa

## Language Overview

Chi is designed to provide a programming environment that uses Chichewa language constructs, making programming more accessible to Chichewa speakers while maintaining modern programming language features.

### Key Features
- **Localized Keywords**: All keywords and operators are in Chichewa
- **Python-like Syntax**: Familiar programming patterns with local language
- **Data Types**: Strings, numbers, booleans, lists, and null values in Chichewa
- **List Operations**: Full support for list manipulation with Chichewa method names
- **Modern Control Structures**: If/else, loops, functions in Chichewa
- **Type System**: Built-in type checking with Chichewa type names
- **Null Handling**: Proper null value support with `palibe`
- **Cultural Authenticity**: All output displays in Chichewa

### Basic Syntax Examples

```chi
# Variable declaration
ika dzina = "Jakesh"

# Conditional statements
ngati dzina wafanana "Jakesh":
    onetsa("Moni!")

# Lists and iteration
ika mylist = ndandanda("apple", "banana", "cherry")
bwereza item mu mylist:
    onetsa(item)

# List methods in Chichewa
mylist.onjezera("orange")        # append
mylist.lowetsa(0, "mango")       # insert
ika count = mylist.werengera("apple")  # count
```

## Examples Directory

Check the `examples/` directory for:
- Basic language examples
- List operation demonstrations
- Control structure usage
- Comprehensive test files

## Contributing

When adding new documentation:
1. Place all documentation files in the `docs/` folder
2. Place all example files in the `examples/` folder
3. Update this README.md to include new documentation files
4. Use clear Chichewa examples where possible

---

*Chi Programming Language - Making programming accessible in Chichewa*

