medley
medley copied to clipboard
Interlisp
more documents and videos for the using-medley path
We established a path through the documentation, but I wanted to make sure there was an open issue to complete the task. In particular, let's make sure the documents are available, indexed in zotero. And please review the YouTube channel and videos there.
=====
A possible way of implementing this engineering approach is to start charting a path through the existing documentation resources.
The path would recommend an ordered list of resources to pursue to arrive to a first stop and gain an introductory understanding, as well as an additional list to proceed to another stop for an advanced understanding.
The path would assume the form of a page or section somewhere under the subtree of the project site on using Medley. It would list the resources and explain for each what the user gains, the parts that may be skipped, any limitations or issues, and so on.
Then we could fill the potholes by adding more itineraries, updating the resources in the lists, producing new documents, and so on.
I can take care of charting the path. As for the issues and discussions tagged Documentation, I can help review them.
Originally posted by @pamoroso in https://github.com/Interlisp/medley/issues/1131#issuecomment-1852843877
All the documents linked from the page Using Medley are now in Zotero. As the next step I may add the videos of our YouTube channel to the Videos collection. What do you think?
videos of the youtube channel, with some annotation (standard metadata sorts of things) would be a good start. Other people have made videos about using Medley with varying degrees of accuracy.... There are also some older videos of demos of systems written in Interlisp. not in the Interlisp youtube channel.
I added our videos to Zotero under Videos.
What about the Interlisp videos by others? Ribbitface alone has dozens.
As I noted in #1083, the RibbitFace videos are instructive. My thought is that we should treat them as a source of ideas for things in Medley that aren't intuitive and need explanation -- places where he says "I'm guessing", for example.