GitBook: No commit message

Author: Abhik

.gitbook/assets/IRM.pdf

@@ -1,4 +1,9 @@
 # Table of contents
 
-* [2023 Medley Interlisp Project Annual Report](README.md)
-* [Page](page.md)
+* [Introduction](README.md)
+* [Getting Medley Up and Running](getting-medley-up-and-running.md)
+* [Understanding and Navigating the Interface](understanding-and-navigating-the-interface.md)
+* [Reading LISP Syntax](reading-lisp-syntax.md)
+* [Atoms, Functions and Lists](atoms-functions-and-lists.md)
+* [Build Your First Interactive Program](build-your-first-interactive-program.md)
+* [All About Files](all-about-files.md)

README.md

@@ -0,0 +1,8 @@
+---
+description: >-
+  The goal of this chapter to introduce the file system, the file browser, how
+  to save and load files. File formats.
+---
+
+# All About Files
+

SUMMARY.md

@@ -0,0 +1,30 @@
+# Atoms, Functions and Lists
+
+#### Atoms
+
+The smallest parts of our code are called atoms. We use them as building blocks for larger tasks. They can be identifiers, symbols, and data. Some atoms are built into the language and help with common tasks, like + for addition. Others are defined by the programmer, like the names of variables or functions.
+
+As we continue, we’ll learn how to combine basic atoms to create more complex logic and programs. 
+
+Note: Don't confuse atoms with operators and syntax elements, which are structural tools that tell the computer how to read our code. In contrast, atoms are the smallest pieces of code in relation to the task at hand.
+
+#### Functions
+
+Functions are reusable tasks broken down into steps for computers to understand. A function is made of three key components:
+
+(1) A name so we can call it. Calling a function tells the computer to start the task. \[Add: How to define a function in Interlisp]
+
+(2) A set of directions telling the computer how to perform the task. \[Add: What marks the beginning and end of arguments in a function?]
+
+(3) Optional parameters that let us change one or more criteria of a task without having to change the underlying flow of logic. \[Add: Where to add parameters]
+
+Functions help us organize our code and save us the trouble of repeating ourselves. Think of them as an easy way to ask the computer to complete a complex task. Rather than describing the task every time, we describe it once and call it by its name when needed. A good practice is to make function names simple but descriptive. 
+
+#### Lists
+
+Lists are ordered groups of atoms enclosed in parentheses. They are fundamental to LISP, as you might have guessed, since LISP is an abbreviation for List Processing. They are how we do things rather than what we do. Lists can contain instructions, data, and other lists. 
+
+One of LISP's special powers is homoiconicity, the ability to treat both code and data as data (inside lists). Programming languages let us automate changing our data. In LISP, we can treat our logic as data and automate its modification as well. Cool!
+
+To wrap your head around the relationship between atoms, lists, and functions, consider this: We can build functions by combining atoms into a list. Our function can be given a name. This name, a symbol, can be used as an atom alongside other atoms in a new list.
+

all-about-files.md

@@ -0,0 +1,8 @@
+---
+description: >-
+  The goal of this chapter is to let readers build a small interface and/or
+  interactive elements like buttons right away.
+---
+
+# Build Your First Interactive Program
+

atoms-functions-and-lists.md

@@ -0,0 +1,24 @@
+# Getting Medley Up and Running
+
+#### Using Medley Online vs Using Medley Locally
+
+* Why choose one over the other?
+
+#### How to Install Medley
+
+* What installation options are available? Which one should you choose and why?
+* What do you need to download and install before installing Medley?
+* How do you install Medley in your OS?
+* How can you find your installation directory?
+* How can you change your installation directory?
+
+#### Running Medley Locally
+
+* How can you run Medley locally after installing?
+* Flags
+
+#### Running Medley Online
+
+* What do the Medley Online starter options mean?
+* Key points to remember when using Medley Online.
+

build-your-first-interactive-program.md

@@ -0,0 +1,8 @@
+---
+description: >-
+  The goal of this chapter is to help readers understand how to read Lisp code
+  by introducing its key syntax elements and delimiters such as () and '
+---
+
+# Reading LISP Syntax
+

getting-medley-up-and-running.md

@@ -0,0 +1,24 @@
+# Understanding and Navigating the Interface
+
+#### Breaking down the interface
+
+* What are the components making up the interface you see on screen when you first start Medley?
+* What do these components do?
+* What do different texts on the screen mean?
+
+#### Navigating the Interface
+
+* How do you move around and interact with the interface?
+* Differences in interactions between modern operating systems and Medley?
+* Mouse movement
+* How can you organize the interface?
+
+#### Interacting with Windows
+
+#### Interacting with Menus
+
+#### What to Do If Things Break
+
+* What to do when you're stuck or when things stop working?
+* How to break out of loops?
+* Keyboard Shortcuts