News for hackers. Stuff that matters.
Re:Racket is 25 by ethagnawl on Sunday May 10, 2020 @02:11PM (#23134678)
Racket has some of the best documentation I've ever seen and is a joy to use. I don't use it, but DrRacket is also a great IDE -- especially for beginners.

I wish either Racket was more widely used in industry or I had more time/energy/excuses to use it.

Re:Racket is 25 by catalogia on Sunday May 10, 2020 @02:52PM (#23135021)
Scribble documentation rendered as HTML is alright, but I wish there was better support for accessing that documentation in your editor. Racket Guide and Racket Reference are both very well written though.
Re:Racket is 25 by sorawee on Sunday May 10, 2020 @05:54PM (#23136623)
In DrRacket, when the cursor is on an identifier, you can hover over the big arrow at the top right corner of the definition window. A popup will appear showing basic usage of functions / macros without detailed explanation. However, you can click "read more..." which will open up the full documentation in a browser. Also, this documentation is installed locally and does not require the internet.
Re:Racket is 25 by pankajdoharey on Sunday May 10, 2020 @04:25PM (#23135845)
The documentation is beautiful but is far from complete, API's lack examples and if you do a search there is confusion about which module the function refers to. I find Clojure and Common Lisp documentation quite complete for a lisp. I also find Ruby docs have tons of example code in its docs. Though I agree none is as beautiful as racket docs.
Re:Racket is 25 by samth on Sunday May 10, 2020 @10:35PM (#23138371)
While I can certainly believe that more examples are needed, the second issue I don't understand. If you search for something, it tells you exactly what module it's from: https://docs.racket-lang.org/search/index.html?q=call-in-con for example.
Re:Racket is 25 by wtetzner on Sunday May 10, 2020 @11:43PM (#23138702)
Yeah, the "provided from <module>" part has been there for a long time.