From e76062edebd75b673f48e349f658e11f47b0e5a4 Mon Sep 17 00:00:00 2001
From: Larry Masinter <LMM@acm.org>
Date: Thu, 14 Mar 2024 08:07:43 -0700
Subject: [PATCH 1/3] No relative URLs... fix up some references

---
 content/en/software/install-and-run/linux/_index.md | 5 +++--
 content/en/software/using-medley/_index.md          | 1 +
 hugo.toml                                           | 2 +-
 3 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/content/en/software/install-and-run/linux/_index.md b/content/en/software/install-and-run/linux/_index.md
index 10aabd959..879c9a0eb 100644
--- a/content/en/software/install-and-run/linux/_index.md
+++ b/content/en/software/install-and-run/linux/_index.md
@@ -8,7 +8,8 @@ type: docs
 ---
 <style>.td-content blockquote { border-left: none; color: inherit; padding-left: 2rem;}</style>
 
-*Note that these instructions do not apply to Linux distros running within Windows System For Linux (WSL).  Separate instructions are available for WSL [here](../windows/wsl).*
+*Note that these instructions do not apply to Linux distros running within Windows System For Linux (WSL).  Separate instructions are available for WSL
+[here](/software/install-and-run/windows/wsl/).*
 
 Medley installs and runs on most recent Linux distros (Alpine Linux is one exception).  All that is strictly required is that the distro include an X Windows server.   Most of the testing for Medley has been done on Ubuntu 20.04 and 22.04.
 
@@ -102,7 +103,7 @@ This will bring up the Medley environment in a separate Window on your Linux des
 
 
 ## **Use Medley**
-Once Medley is up and running, see [here](software/using-medley/) for tips on how to navigate and use the Medley environment.
+Once Medley is up and running, see [here](/software/using-medley/) for tips on how to navigate and use the Medley environment.
 
 By default, Medley will use (creating, if necessary) a directory called *$HOME/il*.  This will be used by the Medley system as its *LOGINDIR* as follows:
  
diff --git a/content/en/software/using-medley/_index.md b/content/en/software/using-medley/_index.md
index 5bc424807..33b448df2 100644
--- a/content/en/software/using-medley/_index.md
+++ b/content/en/software/using-medley/_index.md
@@ -38,6 +38,7 @@ Note: locations of documents are likely to change. Best to bookmark this page, w
 2. [Medley Basics for Common Lisp users](cl-using). 
 If you are familiar with Common Lisp, this guide points out some differences.
 3. [Using Medley Online](online-using) -- additional introduction primarily for online users
+4. [Key bindings](keystrokes) -- a short list of useful but unfamiliar keystrokes.
 1. [Medley for the Novice](/documentation/Medley-Primer.pdf) (also known as Medley Primer).  An introductory guide to the basics of Medley such as executing commands, using menus and files, manipulating windows, editing and saving Lisp code, using the development tools, and more. Read it in full. The code in chapter 20 "Free Menus" doesn't work and some illustrations are missing.
 1. [SEdit — The Lisp Editor](https://drive.google.com/file/d/12LW5zCZauJvC63NRMJhjNv5qJkuuCflb/view?usp=sharing). The manual of SEdit, the default Lisp code editor.
 
diff --git a/hugo.toml b/hugo.toml
index b45d04e86..26584dd27 100644
--- a/hugo.toml
+++ b/hugo.toml
@@ -1,6 +1,6 @@
 baseURL = "https://interlisp.org"
 
-relativeURLs = true
+relativeURLs = false
 canonifyURLs = true
 
 enableRobotsTXT = true

From a6a9af589a44bab2ffc8f8cf2833b3ef8ef00509 Mon Sep 17 00:00:00 2001
From: Larry Masinter <LMM@acm.org>
Date: Thu, 14 Mar 2024 15:13:34 -0700
Subject: [PATCH 2/3] more cleanup of install and run and a few others

---
 content/en/history/_index.md                         |  3 ++-
 content/en/project/partners/_index.md                | 12 +++++-------
 content/en/software/install-and-run/_index.md        | 12 ++++++++++--
 content/en/software/install-and-run/linux/_index.md  |  4 ++++
 .../en/software/install-and-run/windows/_index.md    |  8 +++++---
 .../install-and-run/windows/native/_index.md         |  3 ---
 6 files changed, 26 insertions(+), 16 deletions(-)

diff --git a/content/en/history/_index.md b/content/en/history/_index.md
index 9b88fd9e5..d5f8962fe 100644
--- a/content/en/history/_index.md
+++ b/content/en/history/_index.md
@@ -1,5 +1,6 @@
 ---
-title: History
+title: The History of Interlisp
+linkTitle: History
 weight: 500
 type: docs
 aliases:
diff --git a/content/en/project/partners/_index.md b/content/en/project/partners/_index.md
index 62fd3e5d6..0dc17e34c 100644
--- a/content/en/project/partners/_index.md
+++ b/content/en/project/partners/_index.md
@@ -13,17 +13,17 @@ We joined SPN in 2021 as an "Implementation Sponsor".
 * SPN membership of (mainly academic and  non-profit) organizations
 * We might partner with one or more of their members
 * Membership is $4k/year
-* Hosts [Emulation as a Service infrastructure](https://www.softwarepreservationnetwork.org/emulation-as-a-service-infrastructure/)
+* SPN is Hosted by Educopia, which also hosts [Emulation as a Service infrastructure](https://www.softwarepreservationnetwork.org/emulation-as-a-service-infrastructure/)
 
-### Universities: CSUCI
+### Universities: [SHFT group](SHFT) at University of Alberta
 
-California State University Channel Islands
+This group was reviously located in southern California, at the California State University Channel Islands, now is centered at the University of Alberta, in Canada.
 
 * Professor Eric Kaltman
 
 ### [LFG (Lexical Functional Grammar) group](https://ling.sprachwiss.uni-konstanz.de/pages/home/lfg/ilfga/constitution.html)
 
-* Set up to allow tax-deductable donations for student travel to conferences
+* LFG incorporated to allow tax-deductable donations for student travel to conferences
 * LFG is a current Medley application maintained by Ron Kaplan
 
 ### [Computer History Museum](https://computerhistory.org/)
@@ -34,9 +34,7 @@ California State University Channel Islands
 
 ### Internet Archive
 
-We have no formal relationship with IA, but we would be happy to have one.
-
-* MAME
+We have been working with the Internet Archive to help preserve important artifacts associated with Interlisp-D and systems built using it.
 
 ### [Software Heritage](https://www.softwareheritage.org/)
 
diff --git a/content/en/software/install-and-run/_index.md b/content/en/software/install-and-run/_index.md
index 31dbcb406..9db9ef399 100644
--- a/content/en/software/install-and-run/_index.md
+++ b/content/en/software/install-and-run/_index.md
@@ -11,9 +11,17 @@ weight: 10
 type: docs
 ---
 
-Packaged releases of Medley are available for Linux (most recent distros), MacOS and Windows 10/11.  Both x86_64 and Arm64 systems are supported (as well as Arm7 - e.g., Raspberry Pi - for Linux).  Instructions for installing and running Medley on these platforms are linked below.
+Packaged releases of Medley are available for Linux (most recent distros), MacOS and Windows 10/11.  Both x86_64 and Arm64 systems are supported (as well as Arm7 - e.g., Raspberry Pi - for Linux).  Instructions for installing and running Medley on these platforms can be found:
+
+* [Mac OS](macos)
+* [WIndows](windows)
+* [Linux](linux)
+
+Medley is capable of running on a variety of other OSes including FreeBSD and Solaris as well as on other CPU architectures including i386, SPARC, PowerPC, and Risc-V.  To install and run Medley on these platforms, you will need to build Maiko (the underlying virtual machine for Medley) from the sources available in the Interlisp/maiko repository on github.com.  Instructions for building Maiko can be be found in the [*README* for Maiko](https://github.com/interlisp/maiko#readme). 
+
+To make new Medley sysouts or build your own applications, see the [Building instructions and explanations](https://github.com/Interlisp/medley/blob/master/BUILDING.md).
+
 
-Medley is capable of running on a variety of other OSes including FreeBSD and Solaris as well as on other CPU architectures including i386, SPARC, PowerPC, and Risc-V.  To install and run Medley on these platforms, you will need to build Medley (and its underlying virtual machine, *Maiko*) from the sources available in the Interlisp repos on github.com.  Instructions for building Medley and Maiko can be be found on github in the [*readme* for Maiko](https://github.com/interlisp/maiko) and the [*readme* for Medley](https://github.com/interlisp/medley).
 
 
 
diff --git a/content/en/software/install-and-run/linux/_index.md b/content/en/software/install-and-run/linux/_index.md
index 879c9a0eb..116b52a13 100644
--- a/content/en/software/install-and-run/linux/_index.md
+++ b/content/en/software/install-and-run/linux/_index.md
@@ -8,8 +8,12 @@ type: docs
 ---
 <style>.td-content blockquote { border-left: none; color: inherit; padding-left: 2rem;}</style>
 
+<<<<<<< Updated upstream
 *Note that these instructions do not apply to Linux distros running within Windows System For Linux (WSL).  Separate instructions are available for WSL
 [here](/software/install-and-run/windows/wsl/).*
+=======
+*Note that these instructions do not apply to Linux distros running within Windows System For Linux (WSL).  [Separate instructions are available for WSL herea(/software/install-and-run/windows/wsl).*
+>>>>>>> Stashed changes
 
 Medley installs and runs on most recent Linux distros (Alpine Linux is one exception).  All that is strictly required is that the distro include an X Windows server.   Most of the testing for Medley has been done on Ubuntu 20.04 and 22.04.
 
diff --git a/content/en/software/install-and-run/windows/_index.md b/content/en/software/install-and-run/windows/_index.md
index b844796aa..04763790b 100644
--- a/content/en/software/install-and-run/windows/_index.md
+++ b/content/en/software/install-and-run/windows/_index.md
@@ -7,9 +7,11 @@ type: docs
 
 There are two ways to install and run Medley on Windows. These two ways result in (nearly) identical Medley experiences, but differ in how Medley is installed and started.
 
-1. [Using WSL](wsl) (Windows Syswem for Linux). Medley on WSL requires the WSL subsystem to be installed on your Windows system. And when installing and using Medley on WSL you are working within a Linux environment. Some familiarity with Linux and the Linux command line is helpful.  Medley on WSL is best for users who are running WSL anyway and/or prefer working in a Linux environment.
+1. [Using WSL](wsl) (Windows Syswem for Linux). Medley on WSL requires the WSL subsystem to be installed on your Windows system. When installing and using Medley on WSL, you are working within a Linux environment. Some familiarity with Linux and the Linux command line is helpful. 
 
-2. [Run Medley 'native'](native). Medley 'native' works within the ordinary Windows environment. Installation uses a standard Windows installer and you start Medley from a standard Command (or Powershell) window.  Medley 'native' is best for users who prefer to stay (almost) exclusively in the Windows environment.
+Medley on WSL requires the WSL subsystem to be installed on your Windows system. When installing and using Medley on WSL, you are working within a Linux environment. Some familiarity with Linux and the Linux command line is helpful.  Medley on WSL is best for users who are running WSL anyway and/or prefer working in a Linux environment. See [WSL instructions](wsl).
+
+2. [Medley 'native'](native). Medley 'native' works within the ordinary Windows environment. Installation uses a standard Windows installer; you start Medley from a standard Command (or Powershell) window.  Medley 'native' is best for users who prefer to stay (almost) exclusively in the Windows environment.See [Native instructions](native).
  
 Medley on WSL and 'native' Medley both require 64-bit Windows 10/11.
-
+>>>>>>> Stashed changes
diff --git a/content/en/software/install-and-run/windows/native/_index.md b/content/en/software/install-and-run/windows/native/_index.md
index 747b02b7a..61358800c 100644
--- a/content/en/software/install-and-run/windows/native/_index.md
+++ b/content/en/software/install-and-run/windows/native/_index.md
@@ -71,9 +71,6 @@ This will bring up the Medley environment in a separate Window on your Windows d
 
 ![Medley window open on Windows desktop](../images/Medley-on-Windows.png)
 
-
-
-
 ## Use Medley
 Once Medley is up and running, see [here](/software/using-medley/) for tips on how to navigate and use the Medley environment.
 

From f197a3121544943efa466290fd35ec149825d2b2 Mon Sep 17 00:00:00 2001
From: Larry Masinter <LMM@acm.org>
Date: Thu, 14 Mar 2024 18:34:41 -0700
Subject: [PATCH 3/3] work on making left-column index readable

---
 content/en/software/_index.md                    |  7 +++----
 content/en/software/access-online/_index.md      |  1 +
 content/en/software/using-medley/_index.md       |  1 +
 content/en/software/using-medley/cl-using.md     |  9 +++++----
 content/en/software/using-medley/il-using.md     |  1 +
 content/en/software/using-medley/keystrokes.md   | 12 +++++++-----
 content/en/software/using-medley/online-using.md | 11 ++++++-----
 7 files changed, 24 insertions(+), 18 deletions(-)

diff --git a/content/en/software/_index.md b/content/en/software/_index.md
index ccd091858..2bedf3738 100644
--- a/content/en/software/_index.md
+++ b/content/en/software/_index.md
@@ -1,12 +1,11 @@
 ---
-title: Software
+title: The Medley Software
+linkTitle: Software
 type: docs
-aliases:
-
 ---
 ## Welcome to the Medley Interlisp Experience
 
-The [Medley Interlisp Project](/project) has focused on bringing this [historical software](/history) to life. This section contains information on setting up the Medley system and using it.
+The [Medley Interlisp Project](/project) has focused on bringing this [historical software](/history) to life. This section contains information on setting up the Medley system and using it. 
 
 There are two main ways of running Medley: accessing it online in a web browser or installing and running the system on your computer. Online access is good for trying out Medley without installing anything, as well as for basic usage. Install the system on your computer if you want to run Medley offline, customize the environment, and have direct access to local files.
 
diff --git a/content/en/software/access-online/_index.md b/content/en/software/access-online/_index.md
index ba658ea0f..7de9c4579 100644
--- a/content/en/software/access-online/_index.md
+++ b/content/en/software/access-online/_index.md
@@ -1,5 +1,6 @@
 ---
 title: Access Medley Online
+linkTitle: Online
 weight: 10
 type: docs
 aliases:
diff --git a/content/en/software/using-medley/_index.md b/content/en/software/using-medley/_index.md
index 33b448df2..b0ff67f37 100644
--- a/content/en/software/using-medley/_index.md
+++ b/content/en/software/using-medley/_index.md
@@ -1,5 +1,6 @@
 ---
 title: Using Medley
+linkTitle: Using
 weight: 10
 type: docs
 aliases:
diff --git a/content/en/software/using-medley/cl-using.md b/content/en/software/using-medley/cl-using.md
index c5748c977..70d97ded2 100644
--- a/content/en/software/using-medley/cl-using.md
+++ b/content/en/software/using-medley/cl-using.md
@@ -1,5 +1,6 @@
 ---
-title: Interlisp Basics for Common Lisp users
+title: Interlisp Basics for CommonLispers
+linkTitle: For CommonLispers
 url: /software/using-medley/cl-using/
 type: docs
 weight: 30
@@ -7,13 +8,13 @@ weight: 30
 
 If you are familiar with Common Lisp, this guide helps with some unexpected features.
 
-### Advice for newcomers
+## Advice for newcomers
 
 A coding project is a great learning experience. But porting existing Common Lisp software to Medley may be challenging as a first project.
 
-Modern Common Lisps are similar and implement most of ANSI Common Lisp. Adapting software to these environments usually involves minor modifications you can carry out with familiar tools. But the Medley environment is very different and its Common Lisp farther from ANSI.
+Modern Common Lisps are similar to each other, and implement most of ANSI Common Lisp. Adapting software to these environments usually involves minor modifications you can carry out with familiar tools. But the Medley environment is quite different. 
 
-Porting to Medley is a substantial task for a newcomer who has to deal at the same time with an incomplete Common Lisp implementation, unfamiliar tools, and an unknown workflow.
+Porting Common Lisp libraries to Medley can be a substantial task for a newcomer who has to deal at the same time with an incomplete Common Lisp implementation, unfamiliar tools, and an unknown workflow.
 
 It's like hustling the move to a new country you barely speak the language and know the culture of. Within hours of landing at the airport you attempt to open a bank account, apply for a loan, file for health care, register with the tax system, negotiate renting an apartment, and do the paperwork for requesting the services of utility companies. Doing all this immediately after your arrival is overwhelming at best.
 
diff --git a/content/en/software/using-medley/il-using.md b/content/en/software/using-medley/il-using.md
index 3bc0f1d1e..ac5664a4f 100644
--- a/content/en/software/using-medley/il-using.md
+++ b/content/en/software/using-medley/il-using.md
@@ -1,5 +1,6 @@
 ---
 title: Using Medley Interlisp Basics
+linkTItle: Basics
 weight: 20
 type: docs
 ---
diff --git a/content/en/software/using-medley/keystrokes.md b/content/en/software/using-medley/keystrokes.md
index 60231cb40..d02608aae 100644
--- a/content/en/software/using-medley/keystrokes.md
+++ b/content/en/software/using-medley/keystrokes.md
@@ -1,13 +1,15 @@
 ---
-title: Keystrokes, Mouse menus and Gestures
+title: Keystrokes, Menus, and More
 url: /software/using-medley/keystrokes/
 weight: 40
-aliases:
- - /doc/info/Keystrokes.html
+type: docs
 ---
 
-The handling of keyboard and mouse clicks and gestures is different and varied within the Medley environment. This chart shows common keystrokes.
-[Table of Keystrokes](https://docs.google.com/spreadsheets/d/1FOkrr62TtEhhY49m9U0T_6bvqSGRQt9fBRtMDw0YKtY/edit?usp=sharing) more data.
+The handling of keyboard and mouse clicks and gestures is different from what modern users expect, and varied within the Medley environment. Most of the GUI of Medley had been built haphazardly by different developers. As part of "modernizing" Medley, we're hoping to change some of the non-obvious differences with modern expecation. In the meanwhile, here are some things you might not guess.
+
+This chart shows some commony used keystrokes.
+
+[Table of Keystrokes](https://docs.google.com/spreadsheets/d/1FOkrr62TtEhhY49m9U0T_6bvqSGRQt9fBRtMDw0YKtY/edit?usp=sharing) has even more data.
 
 We'd like to improve keyboard handling but haven't yet found a path.
 
diff --git a/content/en/software/using-medley/online-using.md b/content/en/software/using-medley/online-using.md
index 5e2f341b7..5e26c04f5 100644
--- a/content/en/software/using-medley/online-using.md
+++ b/content/en/software/using-medley/online-using.md
@@ -1,24 +1,25 @@
 ---
 title: Using Medley Online
-weight: 40
+weight: 79
 type: docs
 ---
 
-
-## Starting up
+### Starting up
 
 The Medley Desktop at startup contains 4 windows of interest:
 
 * Prompt Window: The black window at the top of the screen. It is used to display system or application prompts
-* Exec (INTERLISP or XCL) window: The main window where you run functions and develop programs.
+* Exec (INTERLISP or XCL) window: The main window where you run functions and develop programs. It's a kind of "REPL" (read, eval, print loop) with more options and commands.
 * Medley logo window: A window containing the Interlisp Medley logo as a bit map.
 * Status Bar window
 
+(also known as the "who line" shows status of various controls.
+
 Medley Online users get some additional buttons on the right-hand side of the screen.
 
 ### Managing memory images and sessions
 
-Medley has a byte-coded virtual machine architecture with a VM designed for Lisp.  This is a common practice, used by Javascript, Flash and Java and other systems to aid in portability: to support a new architecture, you just port the "virtual machine emulator" rather than the whole system.
+Medley has a byte-coded virtual machine architecture with a VM designed for Lisp.  This is now a common practice, used by Javascript, Flash and Java and other systems to aid in portability: to support a new architecture, you just port the "virtual machine emulator" rather than the whole system.
 
 With Medley, there are two types of files relevant to managing memory images and updating them across sessions: `lisp.virtualmem` and `.sysout`.
 
