Re: Proposal: Deep Dive into the Guile Docs & Makeover Proposal

[Blake Shaw]

Olivier Dion <olivier.dion@polymtl.ca> writes:

> On Thu, 17 Feb 2022, Blake Shaw <blake@nonconstructivism.com> 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 <https://dthompson.us/projects/chickadee.html>.  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”