Skip to content

Conversation

@masinter
Copy link
Member

I updated the documentation links and changed some of the wording.

@masinter masinter requested a review from pamoroso December 18, 2023 05:46
Copy link
Contributor

@pamoroso pamoroso left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I reported a couple of typos but otherwise it looks good to me.

1. [LispCourse notes](https://interlisp.org/pub-pdfs/lispcourse/lispcourse.pdf). The notes of a beginner course on the Interlisp environment that goes from the basics of interacting with the system to programming in Lisp. Highly recommended. Skip the sections on printing and the network as modern Medley doesn't fully implement the described functionality. The formatting of the text is partially broken and some sections are missing.
Items marked with **** are at temporary locations, likely to change.

1. [Interlisp Basics for Common Lisp](/software/using-medley/cl-using)****.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remove ****

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the google drive URLs aren't stable. Maybe copy the files into the webiste repo and commit to updating them there regularly? I just don't want people to bookmark the google drive files.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I missed the leading sentence on the asterisks marking a temporary location.  And, once the website is crawled they'll become part of the site record.  I guess we could disable crawling until things settle down.  But, I'm not sure that's a great idea.

In any case, we need to find permanent locations.  I thought Google URLs were stable - I have a process at work that generates and replaces a document in Google Drive on a regular basis via a GitHub action and I use the URL as a pointer to the current version of the document.  So far, its worked flawlessly.

1. [Interlisp Basics for Common Lisp](/software/using-medley/cl-using)****.
If you are familiar with Common Lisp, this guide points out some differences.
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.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remove  ****

### Medley Interlisp References
### Medley References

- [Medley Primer](/documentation/MedleyPrimer.pdf)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Medley-Primer.pdf fix the file name.

### Medley References

- [Medley Primer](/documentation/MedleyPrimer.pdf)
- [Medley for the Sun Workstation User's Guide](/documentation/SunUserGuide)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

SunUserGuide.pdf add file type ending.

@masinter masinter requested review from pamoroso and stumbo December 18, 2023 16:01
Copy link
Contributor

@pamoroso pamoroso left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@masinter
Copy link
Member Author

masinter commented Dec 18, 2023 via email

@pamoroso
Copy link
Contributor

@masinter Do you mean me? Merging is blocked as the review by @stumbo is pending, should I go ahead with the Merge without waiting for requirements to be met (bypass branch protections) option and merge anyway?

@stumbo stumbo merged commit 7dbc50e into main Dec 19, 2023
@stumbo stumbo deleted the using-update branch December 19, 2023 04:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants