From eb11b09758922a5c66987a94cf36006b627a9639 Mon Sep 17 00:00:00 2001 From: Paolo Amoroso Date: Thu, 2 Apr 2026 13:22:20 +0200 Subject: [PATCH 1/2] Warn the documentation may be out of date Add a disclaimer that the documentation has not been touched in a long time and may be out of date or incorrect. Signed-off-by: Paolo Amoroso --- content/en/software/using-medley/_index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/content/en/software/using-medley/_index.md b/content/en/software/using-medley/_index.md index 8029330d..92843024 100644 --- a/content/en/software/using-medley/_index.md +++ b/content/en/software/using-medley/_index.md @@ -18,6 +18,8 @@ aliases: Whether you're just getting started or refreshing your knowledge of Interlisp, we have a variety of documentation to help you along. +These manuals and publications are valuable resources but, since most have not been changed in a long time, the information they provide may be out of date or incorrect. To address this we do intend to [revise](https://github.com/Interlisp/medley/issues/1080) and [organize the documentation](https://github.com/Interlisp/medley/issues/2102). + ### Getting started To learn Medley we recommend that you go over the following reading lists and pursue the resources in the indicated order. From d99b0afbd15cf61fb3abfbd99e396c3875ae6c5f Mon Sep 17 00:00:00 2001 From: Bill Stumbo Date: Sat, 4 Apr 2026 00:05:55 -0400 Subject: [PATCH 2/2] Put notification in a note block to help draw attention to it. Some rewriting for clarity, combined a couple other paragraphs from later in the document that touched on the same general ideas, --- content/en/software/using-medley/_index.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/content/en/software/using-medley/_index.md b/content/en/software/using-medley/_index.md index 92843024..d1949106 100644 --- a/content/en/software/using-medley/_index.md +++ b/content/en/software/using-medley/_index.md @@ -18,7 +18,10 @@ aliases: Whether you're just getting started or refreshing your knowledge of Interlisp, we have a variety of documentation to help you along. -These manuals and publications are valuable resources but, since most have not been changed in a long time, the information they provide may be out of date or incorrect. To address this we do intend to [revise](https://github.com/Interlisp/medley/issues/1080) and [organize the documentation](https://github.com/Interlisp/medley/issues/2102). +> [!note] +> These manuals and publications are valuable resources but the information provided may be out of date or incorrect. The Medley team will [revise](https://github.com/Interlisp/medley/issues/1080) and [organize the documentation](https://github.com/Interlisp/medley/issues/2102) over time. +> +> The location of documents is likely to change over time as they are updated and organized. This page will be updated as needed. Bookmarking this page will help you find the documents you are interested in. ### Getting started @@ -26,10 +29,6 @@ To learn Medley we recommend that you go over the following reading lists and pu The introductory list gets you started using Medley. The advanced list builds from there and covers programming the system and mastering its tools. -Many of these resources were created decades ago when Medley was a research system and a commercial product, so they may be incomplete or out of date. We will eventually update them. - -Note: locations of documents are likely to change. Best to bookmark this page, which we'll update as the documentation settles down. - #### Introductory material 1. [Medley Interlisp for the Newcomer](https://primer.interlisp.org) (also known as the new Medley Primer). An introductory guide to the basics of Interlisp and the Medley environment that doesn't assume prior knowledge of Lisp. Read it in full. Written in 2025, the guide is designed to ease modern users into the system and replace the [old primer](/documentation/Medley-Primer.pdf) published in 1992, now obsolete.