Would it have helped if the get-directory documentation had included examples? Many parts of Racket's documentation are lacking in example code, especially the less-commonly-encountered parts.
On Tuesday, November 19, 2019 at 10:52:14 PM UTC-8, pow bam wrote: > > Indeed I would have likely never even known that section existed - and > looking at it now I see that it is very dense reading material. I turns my > mind to mush trying to interpret what's being said there. I also happen to > be, by and large, a self-learning lone wolf type. I am a complete novice to > programming but when it came to AutoIt I managed to figure out how to piece > together a fairly complicated and large-ish program only using Google, > typing in Autoit + whateverineededtoknowabout and it invariably led me to > not only just the documentation but a community forum FULL of questions and > answers from years of community involvement. Sadly, Racket has no such > structure in place except this very secluded, small Google group and > smattering of tuts about the web - hardly any of which actually focus in > any depth upon GUI app creation to any real extent, seemingly more > concerned with various game making and animation activities. > > As an example take a look at what happens if I type this into Google for > an AutoIt function: > https://www.google.com/search?q=autoit+get+window+size > > I wind up with a list of forum entries that I can read for clues on what > to do OR I can read the documentation along with all that and if you look > at the documentation.. > https://www.autoitscript.com/autoit3/docs/functions/WinGetClientSize.htm > ..it not only gives me a more traditional breakdown of the function it > then goes on to show me it in real world use/action. That's a powerful > thing to getting new people and beginners in the door and using your > language. I would actually be much happier with a true official forum. > Nothing against Google, I guess, but it feels so spartan and limited > compared to what it could be. > -- You received this message because you are subscribed to the Google Groups "Racket Users" group. To unsubscribe from this group and stop receiving emails from it, send an email to racket-users+unsubscr...@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/racket-users/62cc63a4-196c-4294-b147-6c1ec3023732%40googlegroups.com.
