Re: Guix Documentation Meetup

2022-03-10 Thread Raghav Gururajan
Hello Guix! DATE: Saturday, March 19, 2022. TIME: 15:00 UTC Duration: ~1.5hrs Oops! Forgot to add the meeting link. LINK: https://meet.nixnet.services/b/rag-8bi-sdx-kdf P.S. Thanks to NixNet for providing BBB service. Regards, Raghav "RG" Gururajan. OpenPGP_signature Description: OpenPGP

Re: Guix Documentation Meetup This Saturday (January 15)

2022-01-15 Thread jgart
On Tue, 11 Jan 2022 11:29:44 -0500 jgart wrote: > On Tue, 11 Jan 2022 17:23:38 +0100 Oliver Propst > wrote: > > On 2022-01-11 17:01, jgart wrote: > > > Hi Guixers, > > > > Hi Jgart thanks for the *note. > > > > *will try to attend the meeting. > > Hi Oliver, > > Cool, hope to see you there!

Re: Guix Documentation Meetup

2022-01-12 Thread Leo Famulari
On Sat, Jan 08, 2022 at 11:24:35AM -0500, Matt wrote: > 2. http://excalamus.com/2021-10-06-guix-debug.html The error about "profile contains conflicting entries" is something we should improve the documentation about, for sure. I opened a tracking bug about it:

Re: Guix Documentation Meetup

2022-01-12 Thread Matt
On Wed, 12 Jan 2022 13:41:10 -0500 Leo Famulari wrote > On Sun, Jan 09, 2022 at 04:12:57PM -0500, Matt wrote: > > I did. Maybe you missed the two blog posts I linked in the previous > > email? > > Yeah, I did miss that you intended to contribute them. > > There is

Re: Guix Documentation Meetup

2022-01-12 Thread Leo Famulari
On Sun, Jan 09, 2022 at 04:12:57PM -0500, Matt wrote: > I did. Maybe you missed the two blog posts I linked in the previous email? > Yeah, I did miss that you intended to contribute them. There is another side of my advice about submitting your contributions however you can: It's still

Re: Guix Documentation Meetup

2022-01-11 Thread Matt
On Tue, 11 Jan 2022 21:57:03 -0500 Matt wrote > > On Tue, 11 Jan 2022 20:20:30 -0500 jgart wrote > > > Have you read ambrevar's post called 'Guix Profiles in Practice'? > > > > Unfortunately ambrevar's blog seems to be down at the moment: > > > >

Re: Guix Documentation Meetup

2022-01-11 Thread Matt
On Tue, 11 Jan 2022 20:20:30 -0500 jgart wrote > Have you read ambrevar's post called 'Guix Profiles in Practice'? > > Unfortunately ambrevar's blog seems to be down at the moment: > > https://ambrevar.xyz/guix-profiles/index.html > No, I haven't. Thanks! It's archived:

Re: Guix Documentation Meetup

2022-01-11 Thread jgart
On Tue, 11 Jan 2022 19:59:37 -0500 Matt wrote: > On Tue, 11 Jan 2022 11:24:20 -0500 jgart wrote > > > I'm looking forward to having you at the next docs meetup: > > > > https://lists.gnu.org/archive/html/guix-devel/2022-01/msg00189.html > > > > Are there any particular

Re: Guix Documentation Meetup

2022-01-11 Thread Matt
On Tue, 11 Jan 2022 11:24:20 -0500 jgart wrote > I'm looking forward to having you at the next docs meetup: > > https://lists.gnu.org/archive/html/guix-devel/2022-01/msg00189.html > > Are there any particular sections in the guix manual that you would like > to work on in the

Re: Guix Documentation Meetup

2022-01-11 Thread Matt
> I don't know how many people in the community have > non-CS/Unix/programming backgrounds so I share some personal thoughts > below. It's not that I want to share my life, but it might resonate > with the experiences of others. Thank you for sharing your story. It resonates with me as mine

Re: Guix Documentation Meetup This Saturday (January 15)

2022-01-11 Thread jgart
On Tue, 11 Jan 2022 17:23:38 +0100 Oliver Propst wrote: > On 2022-01-11 17:01, jgart wrote: > > Hi Guixers, > > Hi Jgart thanks for the *note. > > *will try to attend the meeting. Hi Oliver, Cool, hope to see you there! all best, jgart

Re: Guix Documentation Meetup

2022-01-11 Thread jgart
On Mon, 10 Jan 2022 08:15:34 -0500 Matt wrote: > > Also if I understand things correctly there are > > actually plans to host a documentation meetup this Saturday (maybe at > > around 10:30 AM ET as the last ones). > > Thank you! I should be able to attend. > > Is that January 15, at

Re: Guix Documentation Meetup This Saturday (January 15)

2022-01-11 Thread Oliver Propst
On 2022-01-11 17:01, jgart wrote: Hi Guixers, Hi Jgart thanks for the *note. *will try to attend the meeting. -- Kinds regards Oliver Propst https://twitter.com/Opropst

Re: Guix Documentation Meetup

2022-01-10 Thread André A . Gomes
Matt writes: > > I'm not connected with Guix with any way - a mere enthusiast and > > observer. > > I'm not sure what you mean. Being excited about something and taking > the time to observe it, like listening to music, is a connection, > right? I mentioned because ultimately the final word

Re: Guix Documentation Meetup

2022-01-10 Thread Matt
> Please don't misinterpret the following comments. But I don't see how the > 1st one > could land in a cookbook. You're fine, I more or less agree with you. I think something like it with a different package would be helpful. What I wrote probably isn't it. > Yes, I'm not a fan of

Re: Guix Documentation Meetup

2022-01-10 Thread Matt
> Also if I understand things correctly there are > actually plans to host a documentation meetup this Saturday (maybe at > around 10:30 AM ET as the last ones). Thank you! I should be able to attend. Is that January 15, at 10:30 am EST using

Re: Guix Documentation Meetup

2022-01-10 Thread Oliver Propst
Hi Matt I thanks for your very elaborate and insightful mail. As a Guix user and enthusiast I definitely agree that documentation is important for the project. Also if I understand things correctly there are actually plans to host a documentation meetup this Saturday (maybe at around 10:30 AM

Re: Guix Documentation Meetup

2022-01-10 Thread André A . Gomes
Matt writes: > > I see that this all seems confusing. > > Thank you for your response and for acknowledging my perspective. > Yes, I find many things about the documentation process confusing. I > can't speak for others, but I get the strong sense that I'm not alone > in that feeling. You're

Re: Guix Documentation Meetup

2022-01-09 Thread Matt
> I see that this all seems confusing. Thank you for your response and for acknowledging my perspective. Yes, I find many things about the documentation process confusing. I can't speak for others, but I get the strong sense that I'm not alone in that feeling. > If you have something to >

Re: Guix Documentation Meetup

2022-01-08 Thread Leo Famulari
On Sat, Jan 08, 2022 at 11:24:35AM -0500, Matt wrote: > Let me walk through what that looks like from my perspective. I'm afraid, > however, that it comes across as aggressive, ungrateful, or demanding. None > of those are my intent! I genuinely want to help but struggle to understand > the

Re: Guix Documentation Meetup

2022-01-08 Thread Ricardo Wurmus
Matt writes: > > > I would like for Guix to host a community wiki (in addition to a more > discoverable official documentation). > > > > That’s the purpose of the Cookbook, which is open to all contributors. > > The cookbook is a great resource. I'd like to contribute to it. Cool, we’re

Re: Guix Documentation Meetup

2022-01-08 Thread Matt
> > I would like for Guix to host a community wiki (in addition to a more > > discoverable official documentation). > > That’s the purpose of the Cookbook, which is open to all contributors. The cookbook is a great resource. I'd like to contribute to it. Let me walk through what that

Re: Guix Documentation Meetup

2022-01-08 Thread Matt
> Someone was frustrated there was no wiki, so they started that, but it's not > official at all. Miraheze hosts other wikis, like the bootstrappable wiki, I > think it's ok, but if we had a wiki, it should rather be hosted on gnu or > guix infrastructure. Thank you for clarifying. I

Re: Guix Documentation Meetup

2022-01-08 Thread Josselin Poiret
Hello everyone, Matt writes: > > I would like for Guix to host a community wiki > > Agreed. > > Ironically, Guix already has two of them. > > 1. goto gnu.guix.org > 2. Select wiki from the help menu > 3. Discover that linked wiki is not a community wiki > 4. Click the (supposed) community

Re: Guix Documentation Meetup

2022-01-08 Thread Julien Lepiller
Le 8 janvier 2022 14:41:53 GMT+01:00, Matt a écrit : > > > I would like for Guix to host a community wiki > >Agreed. > >Ironically, Guix already has two of them. > >1. goto gnu.guix.org >2. Select wiki from the help menu >3. Discover that linked wiki is not a community wiki >4. Click the

Re: Guix Documentation Meetup

2022-01-08 Thread Matt
> I would like for Guix to host a community wiki Agreed. Ironically, Guix already has two of them. 1. goto gnu.guix.org 2. Select wiki from the help menu 3. Discover that linked wiki is not a community wiki 4. Click the (supposed) community wiki: https://guix.miraheze.org/wiki/Main_Page Is

Re: Guix Documentation Meetup

2022-01-08 Thread calcium
I would like for Guix to host a community wiki (in addition to a more discoverable official documentation). That’s the purpose of the Cookbook, which is open to all contributors. It is not a wiki. You can't edit and review easly, but must instead send a contribution to someone (IRC or

Re: Guix Documentation Meetup

2022-01-08 Thread Ricardo Wurmus
calcium writes: > I would like for Guix to host a community wiki (in addition to a more > discoverable official documentation). That’s the purpose of the Cookbook, which is open to all contributors. -- Ricardo

Re: Guix Documentation Meetup

2022-01-08 Thread calcium
I strongly agree with matt about the importance of discoverability that is currently lacking (`geiser-doc-symbol-at-point isn't enough). Its pretty hard to find out how to do something beyond the basic usage. I would like for Guix to host a community wiki (in addition to a more discoverable

Re: Guix Documentation Meetup

2022-01-07 Thread Matt
I want to be a part of this. I feel like I've been rubbing two sticks together while it seems some people out there have Zippo lighters. A real-time conversation, some paired programming, or simply looking over the shoulder of someone who knows what they're doing would go a long way. I have

Re: Guix Documentation Meetup

2022-01-06 Thread Katherine Cox-Buday
adriano writes: > Il giorno dom, 12/12/2021 alle 21.50 -0600, Katherine Cox-Buday ha scritto: >> - In geiser, run =,a thing-i-want-to-look-for= (this is supposedly an >> apropos command that is supposed to search symbols for you). The command >> returns nothing. > about this, I want to report

Re: Guix Documentation Meetup

2021-12-30 Thread adriano
Il giorno dom, 12/12/2021 alle 21.50 -0600, Katherine Cox-Buday ha scritto: > - In geiser, run =,a thing-i-want-to-look-for= (this is supposedly an > apropos >   command that is supposed to search symbols for you). The command > returns >   nothing. I realize I have to import the module

Re: Guix Documentation Meetup

2021-12-20 Thread adriano
Il giorno sab, 11/12/2021 alle 05.40 +0700, Blake Shaw ha scritto: > > hiya guix, > > @cybersyn from IRC here, I recently contributed my first package, > [notcurses] > > -- > tldr: is there also room to discuss contributing -- and possibly > doing a > sizeable makeover to -- the *Guile*

Re: Guix Documentation Meetup

2021-12-15 Thread jgart
On Wed, 15 Dec 2021 20:12:48 +0100 zimoun wrote: Hi all, Just wanted to share the patches here from the meetup: https://issues.guix.gnu.org/52505 all best, jgart

Re: Guix Documentation Meetup

2021-12-15 Thread zimoun
Hi, On Wed, 15 Dec 2021 at 18:37, Blake Shaw wrote: > > Blake Shaw writes: > > Simon, just peeped your monad tutorial, and gotta say its one of the > clearest presentations of the subject I've seen. Great work! Thanks. If it helps, I can share the Org source file. Cheers, simon

Re: Guix Documentation Meetup

2021-12-15 Thread Blake Shaw
Blake Shaw writes: Simon, just peeped your monad tutorial, and gotta say its one of the clearest presentations of the subject I've seen. Great work! >> I agree. For what it is worth, I tried once to quickly explain monad, >> with the aim of “Store Monad“ in mind, >> >>

Re: Guix Documentation Meetup

2021-12-14 Thread Katherine Cox-Buday
Luis Felipe writes: > Hi, Hello! Thank you for adding some context around why things are laid out the way they are. I just wanted to respond again with gratitude for your work, and to plainly state that I view this work as difficult, with no clear best practice. Sincerely, -- Katherine

Re: Guix Documentation Meetup

2021-12-14 Thread Luis Felipe
Hi, On Tuesday, December 14th, 2021 at 4:01 PM, Katherine Cox-Buday wrote: > Guile: > > - Tutorial for extending a C program with Guile > - The manual > - Scheme Resources > - "The Revised^6 Report on the Algorithmic Language Scheme" > - "" but 7 > - "" but 5 > -

Re: Guix Documentation Meetup

2021-12-14 Thread Katherine Cox-Buday
Here is some analysis on various popular languages' documentation landing pages. I did this on Sunday, but I held it back from my previous message because it was already quite long, and I was worried this would be seen as over-critical and maybe raise the ire of various language fans. But I

Re: Guix Documentation Meetup

2021-12-13 Thread Katherine Cox-Buday
Blake Shaw writes: > Katherine Cox-Buday writes: > > Katherine, reading a big deeper into your user experience report, its really > so so helpful to have this concrete sort of step-by-step user experience > report. Definitely! The first step to resolution is a common understanding. > Would

Re: Guix Documentation Meetup

2021-12-13 Thread Blake Shaw
Katherine Cox-Buday writes: Katherine, reading a big deeper into your user experience report, its really so so helpful to have this concrete sort of step-by-step user experience report. Would you mind if I solicit the list for more reports like this for anyone who might feel like offering them?

Re: Guix Documentation Meetup

2021-12-13 Thread Blake Shaw
Katherine Cox-Buday writes: Katherine this is great material to chew on, much of which I can relate to! -- “In girum imus nocte et consumimur igni”

Re: Guix Documentation Meetup

2021-12-13 Thread Blake Shaw
zimoun writes: Hi Simon, thanks for the input, > Hi, > > On Sat, 11 Dec 2021 at 05:40, Blake Shaw > wrote: > >> -- >> tldr: is there also room to discuss contributing -- and possibly >> doing a >> sizeable makeover to -- the *Guile* documentation? If so, I could >> give a >> short 5 - 10

Re: Guix Documentation Meetup

2021-12-13 Thread zimoun
Hi, On Sat, 11 Dec 2021 at 05:40, Blake Shaw wrote: > -- > tldr: is there also room to discuss contributing -- and possibly doing a > sizeable makeover to -- the *Guile* documentation? If so, I could give a > short 5 - 10 minutes presentation of what I think should be done (and > would

Re: Guix Documentation Meetup

2021-12-12 Thread Katherine Cox-Buday
Blake Shaw writes: > I'd love to know where you found trouble so that I can take that into > consideration when developing a design strategy for the makeover. When reading this, please keep in mind that I have a lot of gratitude for the various maintainers of this software and its respective

Re: Guix Documentation Meetup

2021-12-11 Thread Katherine Cox-Buday
Ryan Prior writes: > I've found the Guile IRC channel to be polite and encouraging, but also very > self-satisfied, which makes it hard to feel heard as a Guile hacker who's > struggling. Consider reaching out to Andy Wingo (wingo in IRC in #guile). I hope I am not laying this issue at his

Re: Guix Documentation Meetup

2021-12-10 Thread Blake Shaw
Ryan Prior writes: > Absolutely. The Guile docs are unusable and make Guile a pain to work > with. I say this as an experienced lisp & scheme user with decades of > experience now in elisp, racket, and clojure. oh good, I'm glad to hear that I'm not alone! to be honest I don't think its *so*

Re: Guix Documentation Meetup

2021-12-10 Thread Ryan Prior
‐‐‐ Original Message ‐‐‐ On Friday, December 10th, 2021 at 10:40 PM, Blake Shaw wrote: > tldr: is there also room to discuss contributing -- and possibly doing a > sizeable makeover to -- the Guile documentation? Absolutely. The Guile docs are unusable and make Guile a pain to work

Re: Guix Documentation Meetup

2021-12-10 Thread Blake Shaw
hiya guix, @cybersyn from IRC here, I recently contributed my first package, [notcurses] -- tldr: is there also room to discuss contributing -- and possibly doing a sizeable makeover to -- the *Guile* documentation? If so, I could give a short 5 - 10 minutes presentation of what I think should