Readme update

README.md

@@ -32,10 +32,14 @@ Distributed under GPLv3 (see [LICENSE](LICENSE))
 
 * multi-pass optimizer (that will even optimize your hand-written assembly if you ask it to)
 
+## More info
+
+* [Documentation](doc/README.md)
+
+* [Example programs](examples/README.md)
+
 ## Planned features
 
 * multi-part programs
 
 * more targets: Famicon/NES, BBC Micro/Electron, Oric computers, Apple II, PC-Engine/Turbografx-16, Atari Lynx
-
-* a better optimizer

examples/README.md

@@ -0,0 +1,26 @@
+# Examples
+
+## Cross-platform examples
+
+* [Hello world](hello_world/hello_world.mfk) (C64/C16/PET/VIC-20/Atari) – simple text output
+
+## Commodore 64 examples
+
+### Console I/O examples
+
+* [Echo](c64/echo.mfk) – simple text input and output
+
+* [Calculator](c64/calculator.mfk) – simple numeric input and output
+
+* [Text encodings](c64/text_encodings.mfk) – examples of text encoding features
+
+* [Panic](c64/panic_test.mfk) – how panic works on C64, showing the address of where it happened
+
+### Graphical examples:
+
+* [Rasterbar](c64/rasterbar.mfk) – simple rasterbar effect
+
+* [Softscrolling](c64/softscroll.mfk) – soft-scrolling a single line of text
+
+* [Galencia starfield](c64/galencia.mfk) – a port of the starfield effect from the game *Galencia* 
+