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

2022-02-19 Thread adriano
Il giorno sab, 19/02/2022 alle 10.33 -0500, Olivier Dion via General Guile related discussions ha scritto: > On Sat, 19 Feb 2022, Neil Jerram wrote: > > > Personally, I am now a big fan of Scheme-centric + FFI, as it means > > always writing Scheme and never having to hack C code.  If everyone >

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

2022-02-19 Thread Olivier Dion via General Guile related discussions
On Sat, 19 Feb 2022, Neil Jerram wrote: > Personally, I am now a big fan of Scheme-centric + FFI, as it means > always writing Scheme and never having to hack C code. If everyone > agreed on that, we could discard all the C-centric parts of the > manual, and focus the rest on a clearer use

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

2022-02-19 Thread Neil Jerram
On Thu, 17 Feb 2022 at 16:59, Blake Shaw wrote: > > https://tube.nocturlab.fr/videos/watch/2b55ca09-f0fd-4899-9cb0-9632cd90b3d1 Wow, what a great reminder of things past! I mean "past" in the sense that I used to be very strongly focused on this, but have not been for some years. The material

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

2022-02-18 Thread Blake Shaw
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.

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

2022-02-18 Thread Olivier Dion via General Guile related discussions
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

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

2022-02-17 Thread Blake Shaw
Blake Shaw writes: hiya guix, my apologies again for the hold up in getting this video to everyone. for those who won't have time to view it, I will rehash the suggested changes in the 5 minutes before; perhaps because of the delay in being able to get this together for everyone we can view my

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

2022-02-16 Thread Blake Shaw
hiya guix, my apologies for not turning my presentation yet! I know people expressed excitement about it so I just want to give you a heads up that I just finished it, but alas I'm too tired to record the video now. but I will do it ang get it turned in first thing in the morning. but i think it

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

2022-02-10 Thread Christine Lemmer-Webber
Lol, wish I had seen this before I shot off my other email. This is great! Glad to see a lot of overlap between our emails.

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

2022-02-08 Thread Daniel Tornabene
Very much agree with "How to setup a project" example, I should consider offering my own example at some point after Blake has worked through his approach. Really onboard with this comment overall, the fact that C interop is included directly in the manual is important, and something I've been

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

2022-02-08 Thread Daniel Tornabene
Looking forward to your talk Blake, don't worry, the gist came across the first time I was just offering my own experience and opinions of the documentation. Genuinely excited to see what you come up with, documentation is one of my favorite things in free software actually On Tue, Feb 8, 2022 at

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

2022-02-08 Thread Blake Shaw
Daniel Tornabene writes: > just a simple guile user here, sitting next to my printed out 2.2.6 > manual. I'm interested in this topic as well though I'd say my own > experience with the documentation is less a problem with it as it is > then with its organization. Perhaps I'm an anomaly, but I

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

2022-02-08 Thread Daniel Tornabene
just a simple guile user here, sitting next to my printed out 2.2.6 manual. I'm interested in this topic as well though I'd say my own experience with the documentation is less a problem with it as it is then with its organization. Perhaps I'm an anomaly, but I enjoy and appreciate a manual with

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

2022-02-08 Thread james
On 22/02/08 02:36pm, Blake Shaw wrote: > > Dear Guix (and guile users, who I've Cc'd), > > My apologies for turning this in last minute. There had been discussion about > this proposal on the guix mailing list, and I had missed that I need to > submit a formal proposal until roptat mentioned

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

2022-02-08 Thread Blake Shaw
james writes: > I too would like to state my interest in your talk. As someone who is > relatively new to GNU Guile, I definitely see the interest in such a > discussion as I do my self sometimes find the documentation a bit hard > to navigate although I don't claim to have any knowledge of the

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

2022-02-08 Thread Olivier Dion via General Guile related discussions
On Tue, 08 Feb 2022, Blake Shaw wrote: > * SUMMARY: Recent discussions on the Guix mailing list revealed that > many in the Guix community have found the Guile Reference Manual > difficult to navigate as newcomers. That should come as no surprise -- > in PDF form, the docs span approximately /850

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

2022-02-08 Thread Blake Shaw
Neil Jerram writes: > Speaking as one of the past authors of the manual, I look forward to > hearing your thoughts. It is genuinely challenging to present this > amount of material and explain its complexity, and there is no reason > at all to consider any current arrangement as cast in stone.

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

2022-02-08 Thread Blake Shaw
Jérémy Korwin-Zmijowski writes: > I could not put a word on it precisely but I was in between the feeling of > having too much info or not > enough. haha I can totally relate! That succinctly captures part of the core issue -- I might quote you on that if you don't mind ;) -- “In girum imus

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

2022-02-08 Thread Jérémy Korwin-Zmijowski
Hey Blake, I look forward to read/watch your thoughts on this topic ! Few years ago I was this newcomer navigating in the Guile Reference Manual. I could not put a word on it precisely but I was in between the feeling of having too much info or not enough. haha Best regards, Jérémy Le

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

2022-02-08 Thread Neil Jerram
Hi Blake, On Tue, 8 Feb 2022 at 08:55, Blake Shaw wrote: > [...] > > Serving at once as a referrence manual & API specification, the large size > may in part be attributed to what simultaneously makes Guile an appealing > project to contribute to, while also rendering the documentation process

Proposal: Deep Dive into the Guile Docs & Makeover Proposal

2022-02-08 Thread Blake Shaw
Dear Guix (and guile users, who I've Cc'd), My apologies for turning this in last minute. There had been discussion about this proposal on the guix mailing list, and I had missed that I need to submit a formal proposal until roptat mentioned it at Fosdem. Nonetheles here it is: * TITLE: A