New topic: asking for help

New topic: asking for help

[Laura Lazzati]

Hi Guix!

Another topic is about asking for help, that is very useful for people
even when reading the documentaiton.

This should include this mailing-list (ie, how to fill the form, maybe
sth about the CoC?), and IRC channel.

Discussion starts :)

Regards!
Laura

Re: New topic: asking for help

[znavko]

[-- Attachment #1: Type: text/plain, Size: 1097 bytes --]

Hello, Laura! Your posts are awesome, cause me too want to have better connection with gurus.

There are lists I've subscribed to: 

Guix Help https://lists.gnu.org/archive/html/help-guix/ <https://lists.gnu.org/archive/html/help-guix/>
Guix Devel https://lists.gnu.org/archive/html/guix-devel/ <https://lists.gnu.org/archive/html/guix-devel/>
Bug Guix https://lists.gnu.org/archive/html/bug-guix/ <https://lists.gnu.org/archive/html/bug-guix/>

You may find Guix IRC channel from here https://www.gnu.org/software/guix/help/ <https://www.gnu.org/software/guix/help/>
I think Freenode is hard to use though tor, proxy.

Here are very responsive people. I like it. Maillists are the secure and useful way for communications. Do you want something else?


Feb 11, 2019, 2:29 PM by laura.lazzati.15@gmail.com:

> Hi Guix!
>
> Another topic is about asking for help, that is very useful for people
> even when reading the documentaiton.
>
> This should include this mailing-list (ie, how to fill the form, maybe
> sth about the CoC?), and IRC channel.
>
> Discussion starts :)
>
> Regards!
> Laura
>


[-- Attachment #2: Type: text/html, Size: 2640 bytes --]

Re: New topic: asking for help

[Laura Lazzati]

Hi znavo!

> Hello, Laura! Your posts are awesome, cause me too want to have better connection with gurus.
Thank you! But i am the Outreachy intern that is making the videos
that are the start point for newcomers :)
>
> There are lists I've subscribed to:
>
> Guix Help https://lists.gnu.org/archive/html/help-guix/
> Guix Devel https://lists.gnu.org/archive/html/guix-devel/
> Bug Guix https://lists.gnu.org/archive/html/bug-guix/
>
> You may find Guix IRC channel from here https://www.gnu.org/software/guix/help/
> I think Freenode is hard to use though tor, proxy.
>
> Here are very responsive people. I like it. Maillists are the secure and useful way for communications. Do you want something else?
I know, the community is lovely :) thanks for the links, I was just
planning to show how to join guix-devel.
What do others think about it?

Regards!
Laura

Re: New topic: asking for help

[Laura Lazzati]

Just wanted to let you know that we will be discussing the content
ofthis video by mail until Friday 7:00 UTC .
After that, feel free to join ##guix-outreachy for the final
discussion on Friday at 12:00 UTC.
Regards :)
Laura

Re: New topic: asking for help

[Björn Höfling]

[-- Attachment #1: Type: text/plain, Size: 915 bytes --]

Hi Laura,

On Mon, 11 Feb 2019 11:29:02 -0300
Laura Lazzati <laura.lazzati.15@gmail.com> wrote:

> Hi Guix!
> 
> Another topic is about asking for help, that is very useful for people
> even when reading the documentaiton.
> 
> This should include this mailing-list (ie, how to fill the form, maybe
> sth about the CoC?), and IRC channel.

I would mention the CoC only marginally, but say that the community is
very welcoming and respectful.

* First entry maybe is the homepage as such.
* Then show the documentation [or: are we here already assuming that
someone found that?].
* Then mailing list (dev/help).
* IRC channel is also quite a help, I would mention that too.
* There is the debbugs bug tracker
(https://debbugs.gnu.org/cgi/pkgreport.cgi?pkg=guix) where you could
search for problems. It is maybe not the most obvious interface and
explaining it a bit would be nice.

Björn

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 195 bytes --]

Re: New topic: asking for help

[Gábor Boskovits]

Hello,

> * First entry maybe is the homepage as such.
> * Then show the documentation [or: are we here already assuming that
> someone found that?].
> * Then mailing list (dev/help).
> * IRC channel is also quite a help, I would mention that too.
> * There is the debbugs bug tracker
> (https://debbugs.gnu.org/cgi/pkgreport.cgi?pkg=guix) where you could
> search for problems. It is maybe not the most obvious interface and
> explaining it a bit would be nice.
>

This ordering looks fine to me.

I would add some emphasis to finding the
documentation and the contact page on the website, but that might be obvious.

I would spilt up showing documentation, and first refer to the
location with the other videos,
then to the manual, the rationale being is that someone who is already
watching a documentation
video might be more interested in documentation videos in the first place.

I guess I would skip the dev list here. I feel it would result in
better distribution of messages. If the
question seems to be dev related, the  either we can redirect the
thread to dev, and most devs will
come across the list of mailing lists on the contact page, and post
there in the first place, so I
guess this would not cause any real concern.

I also believe that the IRC channel is quite important. On thing to
consider here is to mention the
things related to nickname registration and logging in. It is
unfortunate that we were forced to
making registration required, but this is how things are right now.

We might also propose the mumi as the primary issue tracking
interface, and mention debbugs in
case more advanced stuff is needed. No strong opinion here.

Best regards,
g_bor

Re: New topic: asking for help

[Laura Lazzati]

Hi!
> > * First entry maybe is the homepage as such.
Guix site?
> > * Then show the documentation [or: are we here already assuming that
> > someone found that?].
We are adding in every video the link to the full documentation in the
last slide.
> > * Then mailing list (dev/help).
> > * IRC channel is also quite a help, I would mention that too.
> > * There is the debbugs bug tracker
> > (https://debbugs.gnu.org/cgi/pkgreport.cgi?pkg=guix) where you could
> > search for problems. It is maybe not the most obvious interface and
> > explaining it a bit would be nice.
uhm but isn't the idea of the video "hi, I'm new, I am trying to use
GNU Guix, how can I ask for help?" That was what I had in mind, or at
least what I understood. Maybe if there is enough time, we can add it,
but I feel it is kind of advanced for the video.
> >
>
> This ordering looks fine to me.
>
> I would add some emphasis to finding the
> documentation and the contact page on the website, but that might be obvious.
I agree with this, we can show a screenshot of that part of the site :)

>
> I would spilt up showing documentation, and first refer to the
> location with the other videos,
> then to the manual, the rationale being is that someone who is already
> watching a documentation
> video might be more interested in documentation videos in the first place.
I mentioned that the videos show at the end a slide with the link for
the documentation, but does not harm adding it again.
> I guess I would skip the dev list here
OK, just help. is it fine taking snapshots?
> I also believe that the IRC channel is quite important. On thing to
> consider here is to mention the
> things related to nickname registration and logging in.
Here we need to show like in cli sessions or just explain it?
> We might also propose the mumi as the primary issue tracking
> interface, and mention debbugs in
> case more advanced stuff is needed. No strong opinion here.
Already mentioned my idea about debbugs. Don't know what mumi is :/

Regards :)
Laura

Re: New topic: asking for help

[Alex Vong]

[-- Attachment #1: Type: text/plain, Size: 2265 bytes --]

Laura Lazzati <laura.lazzati.15@gmail.com> writes:

> Hi!
>> > * First entry maybe is the homepage as such.
> Guix site?
>> > * Then show the documentation [or: are we here already assuming that
>> > someone found that?].
> We are adding in every video the link to the full documentation in the
> last slide.
>> > * Then mailing list (dev/help).
>> > * IRC channel is also quite a help, I would mention that too.
>> > * There is the debbugs bug tracker
>> > (https://debbugs.gnu.org/cgi/pkgreport.cgi?pkg=guix) where you could
>> > search for problems. It is maybe not the most obvious interface and
>> > explaining it a bit would be nice.
> uhm but isn't the idea of the video "hi, I'm new, I am trying to use
> GNU Guix, how can I ask for help?" That was what I had in mind, or at
> least what I understood. Maybe if there is enough time, we can add it,
> but I feel it is kind of advanced for the video.
>> >
>>
>> This ordering looks fine to me.
>>
>> I would add some emphasis to finding the
>> documentation and the contact page on the website, but that might be obvious.
> I agree with this, we can show a screenshot of that part of the site :)
>
>>
>> I would spilt up showing documentation, and first refer to the
>> location with the other videos,
>> then to the manual, the rationale being is that someone who is already
>> watching a documentation
>> video might be more interested in documentation videos in the first place.
> I mentioned that the videos show at the end a slide with the link for
> the documentation, but does not harm adding it again.
>> I guess I would skip the dev list here
> OK, just help. is it fine taking snapshots?
>> I also believe that the IRC channel is quite important. On thing to
>> consider here is to mention the
>> things related to nickname registration and logging in.
> Here we need to show like in cli sessions or just explain it?
>> We might also propose the mumi as the primary issue tracking
>> interface, and mention debbugs in
>> case more advanced stuff is needed. No strong opinion here.
> Already mentioned my idea about debbugs. Don't know what mumi is :/
>
I don't know what's mumi either. But I think there's a (relatively new)
web frontend for debbugs: https://issues.guix.info/

> Regards :)
> Laura

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 227 bytes --]

Re: New topic: asking for help

[swedebugia]

Alex Vong <alexvong1995@gmail.com> skrev: (16 februari 2019 19:58:39 CET)
>Laura Lazzati <laura.lazzati.15@gmail.com> writes:
>
>
>>> We might also propose the mumi as the primary issue tracking
>>> interface, and mention debbugs in
>>> case more advanced stuff is needed. No strong opinion here.

I agree. 
Although an important missing piece in both debbugs and mumi is the ability to report a bug directly on the webpage.
They are both essentially just listings of bugs.

>> Already mentioned my idea about debbugs. Don't know what mumi is :/
>>
>I don't know what's mumi either. But I think there's a (relatively new)
>web frontend for debbugs: https://issues.guix.info/

Mumi is the debbugs frontend code serving that adress. It is written by Ricardo but very little advertised it seems.

The code is linked in the bottom of the page.

Ricardo maybe you could submit mumi to the list if guile programs on gnu.org to help people find it? And perhaps add the name mumi to issues.guix.info


-- 
Sent from my k-9 mail for Android.