Updated CHANGLOG & README

Author: jeremystevens

CHANGELOG.md

@@ -0,0 +1,36 @@
+
+# Changelog
+
+All notable changes to the Felix Programming Language will be documented in this file.
+
+## [1.0.0] - 2024-02-15
+
+### Added
+- New Felix IDE with syntax highlighting
+- Interactive output window in IDE
+- File save/open functionality
+- Run button to execute Felix programs
+- Support for .fx file extension
+- Build system to create executables
+- Program icon support
+
+### Changed
+- Updated main compiler to read from files instead of hardcoded source
+- Improved error handling and messages
+- Better WHILE loop handling in interpreter
+- Enhanced conditional statements (IF/ELIF/ELSE)
+
+### Features
+- Variables and basic data types
+- Mathematical operations
+- String handling
+- Conditional statements (IF/ELIF/ELSE)
+- Loops (WHILE)
+- Boolean operations (AND, OR, NOT)
+- Print statements
+- Basic error reporting
+
+### Documentation
+- Added user-friendly README.md
+- Included example programs
+- Added child-friendly programming guide

README.md

@@ -3,134 +3,108 @@
   <img src="felix_logo.png" alt="Felix Programming Language" width="150" height="150">
 </div>
 
-# Felix Programming Language Guide
+# Welcome to Felix! 🎮
 
-Hey there! 👋 Let's learn how to write programs in Felix, our friendly programming language. It's easy and fun!
+Hi there! 👋 Let's learn how to use Felix, your new coding friend! It's super easy and fun!
 
-## Writing Your First Program
+## Using the Felix IDE (Your Coding Playground)
 
-### Variables - Like Boxes for Your Data
-Think of variables like labeled boxes where you can store things:
+1. **Starting the IDE**
+   - The Felix IDE window will pop up
+   - This is where you'll write your code!
+
+2. **Writing Your Code**
+   - The big white box in the middle is where you type your code
+   - The black box at the bottom shows what your program does when it runs
+
+3. **Saving Your Work**
+   - Click "File" at the top
+   - Choose "Save" or "Save As" to keep your work safe
+   - Give your file a name ending with `.fx` (like `mygame.fx`)
+
+4. **Running Your Program**
+   - Click "Run" at the top
+   - Choose "Run Program"
+   - Watch what happens in the black box below!
+
+## Let's Write Some Code! 🚀
+
+### Your First Program
+Try typing this in the white box:
 ```
-x = 42          # Stores the number 42 in a box labeled 'x'
-name = "Felix"  # Stores the name "Felix" in a box labeled 'name'
+print "Hello! I'm coding!"
 ```
+Run it and see what happens!
 
-### Printing - Showing Things on Screen
-When you want to see what's in your variable or show a message:
+### Making Variables (Like Magic Boxes)
+Variables are like boxes where you can store things:
 ```
-print "Hello!"  # Shows "Hello!" on screen
-print x        # Shows what's in the 'x' box
+age = 10
+name = "Felix"
+print age        # Shows what's in the age box
+print name       # Shows what's in the name box
 ```
 
-### Math Operations - Calculator Stuff
-You can do math just like with a calculator:
+### Math Time! 🔢
+You can do math just like a calculator:
 ```
 x = 5
 y = 3
-print x + y  # Adds numbers: 5 + 3 = 8
+print x + y  # Adds: 5 + 3 = 8
 print x - y  # Subtracts: 5 - 3 = 2
 print x * y  # Multiplies: 5 * 3 = 15
-print x / y  # Divides: 5 ÷ 3 = 1.666...
+print x / y  # Divides: 5 ÷ 3
 ```
 
-### Making Decisions with IF, ELIF, and ELSE
-You can make your program choose between different options:
+### Making Choices (If-Then)
+Tell your program to make decisions:
 ```
-x = 5
-if x > 10
-    print "x is bigger than 10!"
-elif x > 5
-    print "x is bigger than 5!"
-elif x > 3
-    print "x is bigger than 3!"
+age = 10
+if age > 8
+    print "You're a big kid!"
 else
-    print "x is small!"
-```
-
-The program will check each condition in order and run the first one that's true. If none are true, it will run the else part!
-
-### Using AND and OR
-You can check multiple things at once:
-```
-age = 12
-height = 150
-
-if age > 10 and height > 140
-    print "You can ride the big roller coaster!"
-
-if age < 8 or height < 120
-    print "Please try the kiddie rides"
+    print "You're still little!"
 ```
 
-### Using NOT
-You can check if something is NOT true:
-```
-is_raining = 0
-if not is_raining
-    print "Let's play outside!"
-```
-
-### Repeating Things with WHILE
-Want to do something over and over? Use while:
+### Counting with Loops
+Want to count numbers? Use a while loop:
 ```
 count = 1
 while count < 5
-    print count    # This will print: 1, 2, 3, 4
+    print count    # Prints: 1, 2, 3, 4
     count = count + 1
 ```
 
-## Fun Examples to Try
-
-### Counter Program
-```
-count = 1
-while count < 5
-    print count
-    count = count + 1
-```
-This counts from 1 to 4!
+## Fun Projects to Try! 🌟
 
-### Temperature Check
+### Make a Greeting Card
 ```
-temperature = 25
-if temperature > 30
-    print "It's hot today!"
-if temperature < 15
-    print "It's cold today!"
+name = "Felix"
+print "******************"
+print "* Hi, " + name + "! *"
+print "* You're awesome! *"
+print "******************"
 ```
 
-### Functions - Making Reusable Code
-You can create functions that do specific tasks:
+### Number Guessing Game
 ```
-fun greet(name)
-    print "Hello, " + name
+secret = 7
+guess = 5
 
-fun add(x, y)
-    return x + y
-
-# Using the functions
-greet("Felix")        # Prints: Hello, Felix
-result = add(5, 3)    # result will be 8
-print result
+if guess < secret
+    print "Too low!"
+if guess > secret
+    print "Too high!"
+if guess = secret
+    print "You got it!"
 ```
 
-### Simple Game Score with Functions
-```
-fun check_score(score)
-    if score > 90
-        return "You're a superstar!"
-    if score > 80
-        return "Great job!"
-    return "Keep practicing!"
-
-score = 85
-print check_score(score)
-```
+## Tips for Success 🌈
+- Save your work often!
+- If something doesn't work, check your spelling
+- Have fun experimenting with different numbers and words
+- If you get stuck, try running your program to see what's happening
 
-Remember:
-- Each instruction goes on its own line
-- After if or while, put the things you want to do on the next lines
-- No need for special symbols like ; or ()
+Now you're ready to start coding! Remember, the best way to learn is to try things out and have fun! 🎨
 
-Now go ahead and try writing your own programs! 🚀
+Happy Coding! 🚀