Review and refine the Medley Primer/Medley for the Novice

Interlisp / medley

The main repo for the Medley Interlisp project. Wiki, Issues are here. Other repositories include maiko (the VM implementation) and Interlisp.github.io (web site sources)

https://Interlisp.org

MIT License

376 stars 19 forks source link

Review and refine the Medley Primer/Medley for the Novice #1855

Open abhikhasnain1 opened 1 month ago

abhikhasnain1 commented 1 month ago

The current version of the Medley Primer is 2.0 [release date: February 1992]. The PDF is available through https://interlisp.org/documentation/Medley-Primer.pdf. The original TEDIT files can be accessed on the GitHub repository.

The Primer needs a thorough review of the following elements:

Spelling and grammatical errors.
Validity of provided code and processes on the current version of Medley.
Explanations/demonstrations/methods in need of further clarification.
Any essential restructuring of the document required to improve readability, clarity and the overall experience for beginners using Medley in conjunction with the Primer.

abhikhasnain1 commented 2 weeks ago

This document is intended for recording feedback and remarks generated during the review of the Primer:

Review Log

masinter commented 2 weeks ago

How about a 'primer' site init file that users could start Medley with

./medley --primer

that would get you into running medley with the primer visible and active?

pamoroso commented 2 weeks ago

In such a --primer mode the primer might be packaged for access from DInfo in a way similar to IRM. If I recall correctly there's a Medley tool for processing TEdit files for DInfo.

nbriggs commented 2 weeks ago

Re: "there's a Medley tool for processing TEdit files for DInfo"

The result won't be very interesting if the source TEdit files haven't been set up with use in DInfo in mind. It doesn't add cross-references, index, and the tree structure automatically.