Hacker News new | past | comments | ask | show | jobs | submit login

It's in the style of LISP to have little to none documentation in code, as the code should explain itself

Nearly every Lisp data type and all special forms take docstrings; documentation that gets compiled into your code that can be queried at run time. Lisp was the model for online Unix manual pages; APROPOS and DOCUMENTATION and builtin Common Lisp functions. There is even a defacto commenting style for documenting code at various levels; file-wide, top-level form, and small inline documentation.

The typical "Lisp experience" is a fat abundant system that rivals its underlying OS and platform. It even has a function, ED, to invoke the builtin editor/IDE, and some Lisps even have that builtin.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: