From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Olivier Dion via General Guile related discussions Newsgroups: gmane.lisp.guile.user Subject: Re: Proposal: Deep Dive into the Guile Docs & Makeover Proposal Date: Fri, 18 Feb 2022 12:48:32 -0500 Message-ID: <87zgmodq1b.fsf@laura> References: <871r01sa4a.fsf@nonconstructivism.com> Reply-To: Olivier Dion Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="22911"; mail-complaints-to="usenet@ciao.gmane.io" Cc: guile-user@gnu.org, guix-user@gnu.org To: Blake Shaw , guix-days@gnu.org Original-X-From: guile-user-bounces+guile-user=m.gmane-mx.org@gnu.org Fri Feb 18 18:49:26 2022 Return-path: Envelope-to: guile-user@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1nL7Nm-0005na-3Q for guile-user@m.gmane-mx.org; Fri, 18 Feb 2022 18:49:26 +0100 Original-Received: from localhost ([::1]:34944 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nL7Nk-0003a0-Vz for guile-user@m.gmane-mx.org; Fri, 18 Feb 2022 12:49:25 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:53418) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nL7N8-0003Yt-Ns for guile-user@gnu.org; Fri, 18 Feb 2022 12:48:47 -0500 Original-Received: from smtp.polymtl.ca ([132.207.4.11]:53179) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nL7N5-00085F-Bf; Fri, 18 Feb 2022 12:48:45 -0500 Original-Received: from localhost (modemcable094.169-200-24.mc.videotron.ca [24.200.169.94]) by smtp.polymtl.ca (8.14.7/8.14.7) with ESMTP id 21IHmX3Q000422 (version=TLSv1/SSLv3 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Fri, 18 Feb 2022 12:48:39 -0500 DKIM-Filter: OpenDKIM Filter v2.11.0 smtp.polymtl.ca 21IHmX3Q000422 In-Reply-To: <871r01sa4a.fsf@nonconstructivism.com> X-Poly-FromMTA: (modemcable094.169-200-24.mc.videotron.ca [24.200.169.94]) at Fri, 18 Feb 2022 17:48:34 +0000 Received-SPF: pass client-ip=132.207.4.11; envelope-from=olivier.dion@polymtl.ca; helo=smtp.polymtl.ca X-Spam_score_int: -41 X-Spam_score: -4.2 X-Spam_bar: ---- X-Spam_report: (-4.2 / 5.0 requ) BAYES_00=-1.9, RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: guile-user@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: General Guile related discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guile-user-bounces+guile-user=m.gmane-mx.org@gnu.org Original-Sender: "guile-user" Xref: news.gmane.io gmane.lisp.guile.user:18102 Archived-At: On Thu, 17 Feb 2022, Blake Shaw wrote: > looking forward to any feedback. Some things that I think could use some improvement: When you play a video while you're talking, make sure that the volume of the video is very low so we can still hear you. For example, around 4.20 I can't hear you anymore (headphone). At least the music is good. There's time where you say Guix when you meant Guile or Scheme I think. For example around 13.40, you show a Git tree as a S-exp and refer to Guix. Looks like there's a latency between the audio and video. Maybe it's peertube and not your recorder. If you use the REPL again for a presentation that is presented live, I would suggest to add page number so that it's easier to ask questions and reference the good slide. In theory, one can use the $* variable of the REPL for that also. The very good points of your presentation I think are: Your language is impeccable and very cleared/articulated. I like that you show your real world usage of Guile. I feel that it's very important to show what Guile is capable of and that it can be used in a professional working environment. Overall, a great presentation. For your `scribble jam` project, maybe you should look into guile-chickadee . It's a game development toolkit -- based on guile-opengl -- which I think support most of what you want. So you could use it in some way for your project. Other comments: For `Initialization with C` I would call it `C runtime initialization`. IMO, `Snarfing macro` should be in the same section as FFI. `Scheduling` -> `Multi-Threading` | `Parallelism`. `GOOPS` should be under `Guile Modules` or renamed to `Object Oriented Programming` like `Functionnal programming`. SXML is not just used in Web. So I'm not sure if it should be under the same section. Perhaps under parsing? `File Tree Walk` moved to `File System` and rename `POSIX/File System` to just `File System`. Best regards, old -- Olivier Dion Polymtl