Update CI and docs to use submodules for maiko/notecards/loops/test

doHCFILES.yml: replace 5 separate checkout steps with a single
  checkout using submodules:true; remove now-redundant .git cleanup step.

buildLoadup.yml: add submodules:true to Checkout Medley; remove
  separate Checkout Notecards + tar steps (notecards.tgz was already
  commented out of the release push).

make-gh-pages.md: replace manual clone+copy instructions with
  git clone --recurse-submodules; remove rm -rf of submodule dirs.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

.github/ISSUE_TEMPLATE/primer.yml

@@ -1,6 +1,6 @@
-name: Report an issue with the **Medley Interlisp for the Newcomer** primer
+name: Report an issue with the "Medley Interlisp for the Newcomer" primer
 description: Use this template to report issues or make suggestions.
-title: Title of your issue
+title: "[Primer] <short title here>"
 labels: 
   - primer
   - documentation

.github/ISSUE_TEMPLATE/what_people_are_saying.yml

@@ -1,6 +1,6 @@
-name: "New entry for **What People Are Saying**"
-description: "Suggest a new entry for the **What People are Saying** page"
-title: "What People are Saying suggestion"
+name: New "What People Are Saying" entry
+description: 'Suggest a new entry for the "What People Are Saying" page'
+title: "What People Are Saying suggestion"
 body:
   - type: dropdown
     id: contentType
@@ -24,7 +24,7 @@ body:
     id: additionalInformation
     attributes:
       label:  Additional information
-      description: "Use this space to supply any addiitonal information on the suggested item."
+      description: "Use this space to supply any additional information on the suggested item."
     validations:
       required: false
   - type: markdown

.github/workflows/buildLoadup.yml

@@ -124,6 +124,8 @@ jobs:
       # Checkout latest commit
       - name: Checkout Medley
         uses: actions/checkout@v4
+        with:
+          submodules: true
 
       # Setup release tag
       - name: Setup Release Tag
@@ -191,18 +193,6 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.MAIKO_TOKEN }}
 
-      # Checkout Notecards and tar it in the tarballsdir
-      - name: Checkout Notecards
-        uses: actions/checkout@v4
-        with:
-          repository: ${{ github.repository_owner }}/notecards
-          path: ./notecards
-      - name: Tar notecards into tarball dir
-        run: |
-          mv ./notecards ../notecards
-          cd ../notecards
-          git archive --format=tgz --output="${TARBALL_DIR}/notecards.tgz" --prefix=notecards/ main
-
       # Install vnc
       - name: Install vnc
         run: sudo apt-get update && sudo apt-get install -y tightvncserver

.github/workflows/doHCFILES.yml

@@ -51,33 +51,8 @@ jobs:
 
       - name: Checkout Medley repo
         uses: actions/checkout@v4
-
-      - name: Checkout maiko
-        uses: actions/checkout@v4
         with:
-          repository: ${{ github.repository_owner }}/maiko
-          path: ./maiko
-
-      - name: Checkout notecards
-        uses: actions/checkout@v4
-        with:
-          repository: ${{ github.repository_owner }}/notecards
-          path: ./notecards
-
-      - name: Checkout loops
-        uses: actions/checkout@v4
-        with:
-          repository: ${{ github.repository_owner }}/loops
-          path: ./loops
-
-      - name: Checkout test
-        uses: actions/checkout@v4
-        with:
-          repository: ${{ github.repository_owner }}/test
-          path: ./test
-
-      - name: Cleanup .git for notecards, loops, test
-        run: rm -rf ./notecards/.git ./loops/.git ./test/.git
+          submodules: true
 
       - name: Download Maiko
         run: |

.gitignore

@@ -5,9 +5,6 @@ tmp/*
 # releases directory
 releases/*
 
-# maiko directory
-maiko/
-
 
 # all PDFs (those explicitly checked in aren't ignored
 # normally when you have derived files, you ignore them from git
@@ -31,7 +28,7 @@ loadups/whereis.hash
 loadups/apps.sysout
 loadups/fuller.database
 loadups/build/
-loadups/branches
+loadups/tagged
 loadups/gitinfo
 
 

.gitmodules

@@ -0,0 +1,20 @@
+[submodule "maiko"]
+	path = maiko
+	url = https://github.com/Interlisp/maiko
+	branch = master
+[submodule "notecards"]
+	path = notecards
+	url = https://github.com/Interlisp/notecards
+	branch = main
+[submodule "loops"]
+	path = loops
+	url = https://github.com/Interlisp/loops
+	branch = main
+[submodule "test"]
+	path = test
+	url = https://github.com/Interlisp/test
+	branch = master
+[submodule "online"]
+	path = online
+	url = https://github.com/Interlisp/online
+	branch = main

README.md

@@ -1,12 +1,14 @@
 # Medley 
 
-This repository is for the Lisp environment of [Medley](https://interlisp.org).
+The [Medley Interlisp Project](https://interlisp.org) aims to preserve, revive, and modernize the [Interlisp](https://interlisp.org) software development environment for rapid prototyping, research and Artificial Intelligence created at Xerox PARC since the 1970s.
 
-[Install and Run](https://interlisp.org/software/install-and-run) covers ways to install and start up Medley on Linux systems, MacOS, and Windows (with or without WSL).
+This repository is for the Lisp environment of the [Medley](https://interlisp.org) release of Interlisp. Other repositories hold additional subsystems and applications such as [Maiko](https://github.com/Interlisp/maiko), the implementation (in C) of the Medley virtual machine, the [LOOPS](https://github.com/Interlisp/loops) object-oriented extension of Interlisp, and the [NoteCards](https://github.com/Interlisp/notecards) hypermedia system.
+
+[Install and Run](https://interlisp.org/software/install-and-run) covers ways to install and start up Medley on Linux systems, MacOS, Windows (with or without WSL), and in a web browser.
 
 [Using Medley](https://interlisp.org/software/using-medley/) has an overview and pointers to documentation.
 
-[Interlisp/maiko](https://github.com/Interlisp/maiko), is the repo for the implementation (in C) of the Medley virtual machine. 
+The [Glossary](https://interlisp.org/history/glossary) defines system-specific terms such as "loadup" and "sysout".
 
 ## Releases
 
@@ -67,25 +69,9 @@ If you have a high-resolution display, note that much of the graphics was design
 
 Medley presumes you have a 3-button mouse; the scroll-wheel on some mice acts as one, with some difficulty. Go into XQuartz Preferences/Input and check "Emulate three button mouse" option.
 
-### Running Medley Interlisp (obsolete)
+### Running Medley Interlisp
 
-The `run-medley` script in this repo sets up some convenient defaults. Running Medley can be done by typing:
-```
-$ cd medley
-$ ./run-medley
-```
-
-Or, if you wish to start Medley up with a different SYSOUT:
-
-```
-$ cd medley
-$ ./run-medley <SYSOUT-file-name>
-```
-The first time the system is run it loads the system image that comes
-with the system.  When you exit the system (or "do a `SaveVM`" menu
-option) the state of your machine is saved in a file named
-`~/lisp.virtualmem`.  Subsequent system startups load the
-`~/lisp.virtualmem` image by default.
+The primer [Medley Interlisp for the Newcomer](https://primer.interlisp.org) eases new users into the Interlisp environment. It assumes no prior knowledge of Lisp and covers the user interface, programming and debugging, windows and graphics, and more. We recommend consulting this document to learn how to run and use the system.
 
 ### Exiting The System
 
@@ -123,7 +109,7 @@ Each directory should have a README.md, but briefly
 * BUILDING.md -- instructions on how to make your own loadups
 * clos -- early implementation of Common Lisp Object System
 * CLTL2 -- files submitted to bring Medley up to the conformance to "Common Lisp, the Language" 2nd edition. Not enough to conform to the ANSI standard lisp.
-* docs -- Documentation files (in TEdit format, PDFs, or online help; look [here](https://github.com/Interlisp/medley/Documentation))
+* docs -- Documentation files (in TEdit format, PDFs, or online help
 * fonts -- raster fonts (or font widths) in various resolutions for display, postscript, interpress, press formats
 * greetfiles -- various configuration setups
 * internal -- These _were_ internal to Venue

docs/html-primer/Medley-Primer-OnePage.html

@@ -1,2 +0,0 @@
-<!DOCTYPE  html PUBLIC "-//W3C//DTD XHTML 1.0 Frameset//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"/><title>Medley-Primer-OnePage</title></head><frameset cols="310pt,*" rows="94%"><frame src="Medley-Primer-OnePage_files/headings.htm" name="headings"/><frame src="Medley-Primer-OnePage_files/content.htm" name="content"/></frameset></html>