Skip to content

Commit b58cf00

Browse files
authored
Add section Advice for newcomers (#202)
1 parent 9fc2215 commit b58cf00

File tree

1 file changed

+16
-0
lines changed

1 file changed

+16
-0
lines changed

content/en/software/using-medley/_index.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,22 @@ Whether you're just getting started or refreshing your knowledge of Interlisp, w
2020
The following links lead to PDF files containing Interlisp documentation.
2121
We are in the process of organizing this documentation.
2222

23+
### Advice for newcomers
24+
25+
A coding project is a great learning experience. But porting existing Common Lisp software to Medley may be challenging as a first project.
26+
27+
Modern Common Lisps are similar and implement most of ANSI. Adapting software to these environments usually involves minor modifications you can carry out with familiar tools. But the Medley environment is completely different and its Common Lisp farther from ANSI.
28+
29+
Porting to Medley is a substantial task for a newcomer who has to deal at the same time with an incomplete Common Lisp implementation, unfamiliar tools, and an unknown workflow.
30+
31+
It's like hustling the move to a new country you barely speak the language and know the culture of. Within hours of landing at the airport you attempt to open a bank account, apply for a loan, file for health care, register with the tax system, negotiate renting an apartment, and do the paperwork for requesting the services of utility companies. Doing all this immediately after your arrival is overwhelming at best.
32+
33+
For a more enjoyable stay take the time to settle, absorb the local language and culture, and live like a native.
34+
35+
Rather than porting Common Lisp programs, it's better to start with small Interlisp projects that rely only on Medley's features and resources with no external dependencies or interactions. Write Interlisp code from scratch instead of bringing in existing software.
36+
37+
We recommend to take Medley a little bit at a time. [Read the introductory material](#introductory-material), and write at least one or two small Interlisp programs of no more than a thousand lines of code.
38+
2339
### Getting started
2440

2541
To learn Medley we recommend that you go over the following reading lists and pursue the resources in the indicated order.

0 commit comments

Comments
 (0)