redo intro

content/en/project/_index.md

@@ -29,7 +29,7 @@ We are trying to address this conflict by also making older versions of Interlis
 We are [some of the original developers and users of Interlisp](/project/credits) 30 years ago, joined by newcomers interested in software history and preservation, along with members of the Lisp community. We work with [organizational partners](partners). And with you!
 
 <div class="mx-auto">
- <a class="btn btn-lg btn-danger mr-3 mb-4" href="">
+ <a class="btn btn-lg btn-danger mr-3 mb-4" href="getinvolved">
   How do I get involved?<i class="fas fa-arrow-alt-circle-right ml-2"></i>
 </a>
 </div>

content/en/project/partners/SHFT.md

@@ -0,0 +1,10 @@
+---
+title: Software History Futures and Technologies SHFT
+weight: 20
+type: docs
+---
+
+The [Software History Futures and Technologies](https://www.shft.group) (SHFT) group] is now hosted by the Media and Technology Studies department at University of Alberta, Canada. SHFT is partnering with the Medley Interlisp project to help with making the Interlisp Experience accessible to those interested in learning its unique features as well as the context of innovation based on it.
+
+
+

content/en/software/_index.md

@@ -4,18 +4,17 @@ type: docs
 aliases:
 
 ---
-This section contains information on installing or setting up Medley and using it.
+## Welcome to the Medley Interlisp Experience
 
-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 best 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, or simplify the exchange of files with Medley.
+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.
 
-We are working on making an early version of Medley run in the browser. This example of software preservation will let you access a technology artifact of historical significance.
+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.
 
-These are the available options for running Medley:
+* [Access Medley Online](access-online): how to access Medley running on our servers using your web browser. 
+* [Install and Run](install-and-run): how to set Medley up on your computer, and (re)start each time.
 
-* [Access Medley Online](access-online): how to access Medley running on our servers using your web browser.
-* [Install and Run](install-and-run): how to set Medley up on your computer, and restart each time.
-* [Using Medley](using-medley): Once you are up and running, some basics and pointers to other documentation.
+Once you are up and running, see "[Using Medley](using-medley)" for some basics and pointers to other documentation.
 
 * *Coming*: [Running Medley in the browser!!](https://groups.google.com/g/lispcore/c/tiD2PUzBLCo/m/HuqWV63_AQAJ)
 
-
+We are working on making earlier version of Interlisp-D run in the browser. This example of software preservation will let you access a technology artifact of historical significance.

content/en/software/access-online/_index.md

@@ -10,12 +10,12 @@ aliases:
   - /software/access-online
 ---
 
-Running Interlisp online is good for experimenting and introducing yourself to the environment. However, anything you create in the online environment should be treated as transient. If you're interested in developing and experimenting with Lisp programs, you will want to investigate other options. For a first foray, it is a good starting point.
+Running Medley online is good for experimenting and introducing yourself to the environment. However, anything you create in the online environment should be treated as transient. If you're interested in developing and experimenting with Lisp programs, you will want to investigate other options. For a first foray, it is a good starting point.
 
 ### Things to note when running online
 
 * **Browser compatibility:** Older browsers may not support the VNC software we use; it should give you a warning if this is detected.
- **control-character conflicts:** Different browsers may intercept user typing control-characters; for example, control-W might close the entire Medley window, rather than backward-delete a word. There is no standard fix: Using Chrome in "full screen" mode; using a browser extension which captures the control-character for its own operations might help. 
+* **Control-character conflicts:** Different browsers may intercept user typing control-characters; for example, control-W might close the entire Medley window, rather than backward-delete a word. There is no standard fix: Using Chrome in "full screen" mode; using a browser extension which captures the control-character for its own operations might help. 
 * **No guarantees:** In general, Medley has NO WARRANTY, but in particular we make no guarantees that private information will not be revealed, or that your files uploaded to your account will be held securely.
 * **Reliable Internet:** You need a solid net connection to our AWS server (currently in Ohio).
 
@@ -25,59 +25,22 @@ Running Interlisp online is good for experimenting and introducing yourself to t
 {{< imgproc Login_Screen Resize "400x450">}} Interlisp Online Login {{< /imgproc >}}
 2. Login to Medley Interlisp Online:
    * You can login as a guest by clicking <img src="Guest_Login_button.png" alt="Guest Login button"> on the login screen. However, guest sessions are not saved.
-   or
    * We suggest you create your own account by clicking <img src="New_User_Register_here_button.png" alt="New User Register here button"> on the login screen. Having an account enables you to save your sessions. To create an account, you just need an email address and password. Click Register here on the login screen to create your own account.
-   or
+
    * If you are already registered (created an account), log in and start a Medley Interlisp session. Sessions are preserved for users that login with their own account. However, user account sessions may be deleted after 30 days of inactivity.
 
-3. Select the Exec you want to run. For this exercise, select `Interlisp`
+3. Select the Exec you want to start out with. For example, select `Interlisp`. 
 
-4. Leave the `Fill browser window` option set.
+4. Leave the `Fill browser window` option set. 
 
 5. Select `Run Medley`.
 Your browser will open a window that represents the Interlisp Desktop and looks much like this:
 
 {{< imgproc Online_Initial_Medley Resize "800x450">}} Medley Interlisp{{< /imgproc >}}
 
-The Interlisp 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) window: The main window where you run functions and develop programs.
-* Medley logo window: A window containing the Interlisp Medley logo as a bit map.
-* Status Bar window
-
-### Writing a sample Interlisp programs
-
-In the Exec window, type the following:
-
-```lisp
-(PLUS 1 1)
-```
-
-When you complete typing the ending `)` the Interlisp interpreter will perform the calculation and return the result.
-
-One thing you probably noticed, the command `PLUS` is capitalized. It’s not that the developers of Interlisp were always shouting at each other. Rather, when Interlisp was developed computer programming was in its infancy and standards for naming commands were still evolving.
-
 <div class="mx-auto">
- <a class="btn btn-lg btn-danger mr-3 mb-4" href="{{< relref "../.." >}}">
-  Guide to help you begin programming in Interlisp<i class="fas fa-arrow-alt-circle-right ml-2"></i>
+ <a class="btn btn-lg btn-danger mr-3 mb-4" href="{{< relref "../using-medley/" >}}">
+  Guide to Using Medley<i class="fas fa-arrow-alt-circle-right ml-2"></i>
  </a>
 </div>
 
-### Managing memory images and sessions
-
- (What is a memory image? How is it different from an image or memory?)
-
-In Interlisp, there are two types of files relevant to managing memory images and updating them across sessions: `lisp.virtualmem` and `.sysout`.
-
-The `lisp.virtualmem` file is a capture of the "current" state of the system (i.e., it is a copy of the virtual memory at a point in time). `lisp.virtualmem` is written whenever you execute `(IL:LOGOUT)` and also whenever executing `(IL:SAVEVM)`. You can restart Medley using a `lisp.virtualmem` and it will pick up essentially where it left off before the `LOGOUT` or `SAVEVM` (with the exception that the user can set `BEFORE`/`AFTER` and `LOGOUT`/`SAVEVM` code that runs before you get control of the restarted `lisp.virtualmem`).
-
-A `.sysout` is a virtual memory image produced by `MAKESYS` (for writing an image for distribution) and `SYSOUT` (for saving a named checkpoint, e.g. to revert to a previous state if needed), which differ in the way they process the startup options. You can (and most frequently do) start Medley from a sysout file. When Medley starts from a sysout, it automatically runs initialization scripts — a site initialization script followed by a per-user initialization script (if available). A sysout is what you might call "a clean image".
-
-As for Interlisp Online: except as noted below, every time you `Run Medley` you are starting up from a sysout file (i.e., from a clean image). The exception is if you check the `Resume previous session` box. In that case, you will be starting up from the `lisp.virtualmem` stored for you online (if any) and that was created by the `(IL:LOGOUT)` at the end of your previous session.
-
-As a registered Interlisp Online user you get the choice of resuming your previous image or starting from a clean image — with the default being starting from a clean image.
-
-For guest logins, there is no `Resume previous session` because `lisp.virtualmem` is never preserved for guests.
-
-For registered users, any files that you create (e.g., with `IL:MAKEFILE`) will also be preserved across sessions online. But these files will never be automatically loaded into the system when you re-start with a clean image — you need to `LOAD` them explicitly (or add a `LOAD` to your personal `INIT` file stored online at `{DSK}/home/medley/il/INIT`).

content/en/software/install-and-run/linux/_index.md

@@ -1,13 +1,14 @@
 ---
 title: Install and Run on Linux
+linkTitle: Linux
 weight: 20
 aliases:
  - /software/install-and-run/running-on-linux/
 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](../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.
 
@@ -95,14 +96,13 @@ Documentation for the `<flags and options>` to the `medley` command can be found
 
 For first-time users: `medley --vnc --apps --interlisp --noscroll` or, equivalently, `medley -v -a -e -n` is a good starting point.  This will give you a fully populated Medley system, including the applications built on Medley such as Notecards and Rooms.
 
-This will bring up the Medley environment in a separate Window on your Windows desktop.  The Medley desktop and windows will all be contained within this Window as shown below.
-
-![Medley window open on Windows desktop](./images/Medley-on-Linux.png)
+This will bring up the Medley environment in a separate Window on your Linux desktop.  The Medley desktop and windows will all be contained within this Window as shown below.
 
+![Medley window open on Linux desktop](./images/Medley-on-Linux.png)
 
 
 ## **Use Medley**
-Once Medley is up and running, see [here](../../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:
 

content/en/software/install-and-run/linux/linux-local-from-github.md

@@ -5,6 +5,7 @@ toc_hide: true
 hide_summary: true
 type: docs
 ---
+
 <style>.td-content blockquote { border-left: none; color: inherit; padding-left: 2rem;}</style>
 
 1.  Go to the [Releases page for Interlisp/Medley on github.com](https://github.com/interlisp/medley/releases).  Here you will see a list of releases in reverse chronological order.  

content/en/software/install-and-run/linux/linux-standard-from-github.md

@@ -5,6 +5,7 @@ toc_hide: true
 hide_summary: true
 type: docs
 ---
+
 <style>.td-content blockquote { border-left: none; color: inherit; padding-left: 2rem;}</style>
 
 1.  Go to the [Releases page for Interlisp/Medley on github.com](https://github.com/interlisp/medley/releases).  Here you will see a list of releases in reverse chronological order.  

content/en/software/install-and-run/macos/_index.md

@@ -1,11 +1,13 @@
 ---
 title: Install and Run on MacOS
+linkTitle: MacOS
 weight: 30
 type: docs
 aliases:
   - /running/running-on-mac
   - /software/install-and-run/running-on-mac/
 ---
+
 <style>.td-content blockquote { border-left: none; color: inherit; padding-left: 2rem;}</style>
 
 ## **Prerequisite: Install XQuartz**
@@ -22,11 +24,11 @@ Medley releases on MacOS are distributed as a .zip file.  The .zip file contains
 
 To install Medley:
 
-1. Download the latest release .zip from the [Medley downloads page](https://online.interlisp.org/downloads/medley_downloads.html) , under the heading "MacOS ...".
+1. Download the latest release .zip from the [Medley downloads page](https://online.interlisp.org/downloads/medley_downloads.html), under the heading "MacOS ...".
 
  <div align="center"><img alt="Medley Downloads Page" width=500 src="./images/downloads-page-macos.png"><p>&nbsp;</p></div>
 
->> You can also download the installation .zip file for the latest as well as any prior releases from the Medley Releases page on the Interlisp GitHub site.  [Instructions for this can be found here](./macos-from-github). 
+>> You can also download the installation .zip file for the latest as well as any prior releases from the Medley Releases page on the Interlisp GitHub site. Instructions for this can be found [here](macos-from-github). 
 
 2.  Copy the downloaded *medley-full-macos-universal...zip* file (which MacOS treats as an unzipped folder) from the Downloads folder into any folder of your choosing.  Optionally,  rename the target folder of the copy from *medley-full-macos-universal...* to something more manageable - e.g., *medley-latest*.  For the purposes of these instructions, we will call this (renamed) folder the *\<medley_folder>*.
 
@@ -88,7 +90,7 @@ This will bring up the Medley environment in a separate window on your desktop.
 ![Medley window open on MacOS desktop](./images/Medley-on-MacOS.png)
 
 ## **Use Medley**
-Once Medley is up and running, see [here](../../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:

content/en/software/install-and-run/windows/_index.md

@@ -1,21 +1,15 @@
 ---
 title: Install and Run on Windows
+linkTitle: Windows
 weight: 40
 type: docs
 ---
 
-There are two ways to install and run Medley on Windows:
- 1.  Run Medley on Windows System for Linux (WSL)
- 2.  Run the 'native' Medley Windows app
+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.
 
-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.
 
-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.
-
-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.
+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 and 'native' Medley both require 64-bit Windows 10/11.
 
-
-
-

content/en/software/install-and-run/windows/native/_index.md

@@ -1,10 +1,12 @@
----
-title: Install and Run on Windows "natively"
+---
+title: Install and Run on Windows "native"
+linkTitle: native
 weight: 40
 type: docs
 aliases:
  - /software/install-and-run/running-on-win/
 ---
+
 <style>.td-content blockquote { border-left: none; color: inherit; padding-left: 2rem;}</style>
 
 When running on Windows natively, Medley will be installed into a directory of your choice.  This directory will contain an isolated copy of the Cygwin environment (an adaptation of Linux tools and apps to Windows) and a version of Medley that runs within that specific Cygwin environment.  This presence of Cygwin, however, is largely hidden from the user and Medley behaves as if it is a native Windows app.
@@ -16,7 +18,7 @@ When running on Windows natively, Medley will be installed into a directory of y
 
 &nbsp;
 
-   > >Alternatively, you can download the Medley Windows installer for the current or any previous release from the Medley Releases page on the Interlisp GitHub site.  [Instructions for this can be found here](./windows-native-from-github).
+   > >Alternatively, you can download the Medley Windows installer for the current or any previous release from the Medley Releases page on the Interlisp GitHub site.  [Instructions for this can be found here](windows-native-from-github).
 
  2. Start the Medley installation app (e.g., by double clicking on the .exe just downloaded).
 
@@ -73,7 +75,7 @@ This will bring up the Medley environment in a separate Window on your Windows d
 
 
 ## Use Medley
-Once Medley is up and running, see [here](../../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.
 
 To exit Medley, type ```(IL:LOGOUT)``` at any Exec window prompt.