-
-
Notifications
You must be signed in to change notification settings - Fork 9
move Using.md to using-medley and update documentation #197
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
pamoroso
left a comment
There was a problem hiding this 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)****. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Remove ****
There was a problem hiding this comment.
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.
There was a problem hiding this comment.
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. |
There was a problem hiding this comment.
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) |
There was a problem hiding this comment.
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) |
There was a problem hiding this comment.
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.
pamoroso
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM
|
if you approve this PR, I can merge it and run the 'check webiste for
broken external links' again.
…On Mon, Dec 18, 2023 at 8:37 AM Paolo Amoroso ***@***.***> wrote:
***@***.**** commented on this pull request.
LGTM
—
Reply to this email directly, view it on GitHub
<#197 (review)>,
or unsubscribe
<https://github.com/notifications/unsubscribe-auth/AAIQTKYTRPQLW6MQQTAAOCLYKBWLDAVCNFSM6AAAAABAY7BH72VHI2DSMVQWIX3LMV43YUDVNRWFEZLROVSXG5CSMV3GSZLXHMYTOOBXGI4TKMBZGA>
.
You are receiving this because you authored the thread.Message ID:
***@***.***>
|
I updated the documentation links and changed some of the wording.