From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Blake Shaw Newsgroups: gmane.lisp.guile.user Subject: Re: Proposal: Deep Dive into the Guile Docs & Makeover Proposal Date: Sat, 19 Feb 2022 01:05:18 +0700 Message-ID: <87bkz4xd7l.fsf@nonconstructivism.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="26601"; mail-complaints-to="usenet@ciao.gmane.io" Cc: guix-days@gnu.org, guile-user@gnu.org, guix-user@gnu.org To: Olivier Dion Original-X-From: guile-user-bounces+guile-user=m.gmane-mx.org@gnu.org Fri Feb 18 19:05:53 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 1nL7dg-0006gC-Fc for guile-user@m.gmane-mx.org; Fri, 18 Feb 2022 19:05:52 +0100 Original-Received: from localhost ([::1]:56508 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nL7df-0001yf-Dg for guile-user@m.gmane-mx.org; Fri, 18 Feb 2022 13:05:51 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:57204) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nL7dT-0001x4-GY for guile-user@gnu.org; Fri, 18 Feb 2022 13:05:39 -0500 Original-Received: from out1.migadu.com ([91.121.223.63]:59735) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nL7dR-0002HG-AA for guile-user@gnu.org; Fri, 18 Feb 2022 13:05:39 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nonconstructivism.com; s=key1; t=1645207523; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=XPojFy964lci8KXKZhFas/T+qDDyep76K/MUerhJvic=; b=X9G+kEZ7y0AcYI6L5Bf0NQCEtOo1XTrNrYliG5/kllsJsY9q4/UmD4cdMDN68V6axjXc0a DZgkdKlJOjDy1dz2cWj3ID/knB1XxLKB3p/DCe++ltT4Bs241HfTs/siIy8ZoWtqcniPf2 hLbZI3ZYXz4fopgpAxrpYoUZP2hP9Ug= Gcc: nnimap+imap.migadu.de:sent.2022 X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. X-Migadu-Flow: FLOW_OUT X-Migadu-Auth-User: nonconstructivism.com Received-SPF: pass client-ip=91.121.223.63; envelope-from=blake@nonconstructivism.com; helo=out1.migadu.com X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, SPF_HELO_NONE=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:18103 Archived-At: Olivier Dion writes: > 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. > noted! first screencast on Guix so a few issues I didn't anticipated, I'll keep them in mind for next time. > 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. > thanks! > 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. > yes, I've looked at it, but not deeply (this was a recently commissioned work). I won't really be getting started on scribble jam for a few weeks, but will poke at chickadee to see if it's suitable in the meantime. > 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 thanks for the feedback and hope you join in tomorrow. best, blake -- “In girum imus nocte et consumimur igni”