From mboxrd@z Thu Jan 1 00:00:00 1970 From: Laura Lazzati Subject: We need your feedback of the documentation videos! Date: Tue, 16 Jul 2019 12:11:22 -0300 Message-ID: Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="00000000000045a031058dcdcc5f" Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:55852) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hnP7a-000772-21 for guix-devel@gnu.org; Tue, 16 Jul 2019 11:12:03 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hnP7Y-0003Nl-LQ for guix-devel@gnu.org; Tue, 16 Jul 2019 11:12:01 -0400 Received: from mail-wm1-x335.google.com ([2a00:1450:4864:20::335]:51859) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hnP7Y-0003Md-Da for guix-devel@gnu.org; Tue, 16 Jul 2019 11:12:00 -0400 Received: by mail-wm1-x335.google.com with SMTP id 207so19062758wma.1 for ; Tue, 16 Jul 2019 08:11:59 -0700 (PDT) List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: Guix-devel --00000000000045a031058dcdcc5f Content-Type: text/plain; charset="UTF-8" Hi Guix! We are about to publish the existing documentation videos and we need your help! If you are interested, please, watch them https://archive.org/details/guix-videos and give feedback here :) We will appreciate it very much, and the idea is to collect the feedback up to next Tuesday (July 23rd) Kind regards! Laura --00000000000045a031058dcdcc5f Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
Hi Guix!

We are about to pub= lish the existing documentation videos and we need your help!
If you are interested, please, watch them https://archive.org/details/guix-videos and give f= eedback here :)
We will appreciate it very much, and the idea is = to collect the feedback up to next Tuesday (July 23rd)

=
Kind regards!
Laura


<= div>
--00000000000045a031058dcdcc5f-- From mboxrd@z Thu Jan 1 00:00:00 1970 From: "pelzflorian (Florian Pelz)" Subject: Re: We need your feedback of the documentation videos! Date: Tue, 16 Jul 2019 19:40:40 +0200 Message-ID: <20190716174040.7to5r7b2pjurugtv@pelzflorian.localdomain> References: Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:44834) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hnRRW-0003Jg-SR for guix-devel@gnu.org; Tue, 16 Jul 2019 13:40:47 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hnRRV-00061P-PB for guix-devel@gnu.org; Tue, 16 Jul 2019 13:40:46 -0400 Received: from pelzflorian.de ([5.45.111.108]:36198 helo=mail.pelzflorian.de) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hnRRV-0005xF-7d for guix-devel@gnu.org; Tue, 16 Jul 2019 13:40:45 -0400 Content-Disposition: inline In-Reply-To: List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: Laura Lazzati Cc: Guix-devel On Tue, Jul 16, 2019 at 12:11:22PM -0300, Laura Lazzati wrote: > If you are interested, please, watch them > https://archive.org/details/guix-videos and give feedback here :) The videos are amazing. Please reference these in all related sections of the manual (once published). The videos will be very valuable when explaining Guix. I would be happy if there were many translations for the videos, however I will not help speak one myself. When publishing, maybe reference their license and source code (but not within the video) and how translators/speakers can contribute. Regards, Florian From mboxrd@z Thu Jan 1 00:00:00 1970 From: Dimakakos Dimos Subject: Re: We need your feedback of the documentation videos! Date: Wed, 17 Jul 2019 09:31:18 +0300 Message-ID: <87zhldmatl.fsf@teknik.io> References: Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:39200) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hndTI-0003QW-Ef for guix-devel@gnu.org; Wed, 17 Jul 2019 02:31:25 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hndTH-00026c-FQ for guix-devel@gnu.org; Wed, 17 Jul 2019 02:31:24 -0400 Received: from mail.teknik.io ([5.79.72.163]:63762) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hndTH-000241-50 for guix-devel@gnu.org; Wed, 17 Jul 2019 02:31:23 -0400 In-reply-to: List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: guix-devel@gnu.org Laura Lazzati writes: > Hi Guix! > > .... > > Kind regards! > Laura Just watched the videos, great work! I agree with Florian that translations would be really cool. Also I think it would be nice to have a video that is about why guix works this way and what are advantages of the ways it works. The packaging videos were amazing, clear and very useful. Thanks for the beautiful work, Dimos. From mboxrd@z Thu Jan 1 00:00:00 1970 From: Tanguy Le Carrour Subject: Re: We need your feedback of the documentation videos! Date: Wed, 17 Jul 2019 09:11:34 +0200 Message-ID: <20190717071134.6av7lnr4pu2eyr3c@rafflesia.localdomain> References: Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:51484) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hne6I-0003t8-3L for guix-devel@gnu.org; Wed, 17 Jul 2019 03:11:43 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hne6G-0003i6-Tq for guix-devel@gnu.org; Wed, 17 Jul 2019 03:11:41 -0400 Received: from relay5-d.mail.gandi.net ([217.70.183.197]:55647) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hne6G-0003eq-My for guix-devel@gnu.org; Wed, 17 Jul 2019 03:11:40 -0400 Content-Disposition: inline In-Reply-To: List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: Laura Lazzati Cc: Guix-devel Hi Laura, Hi Guix! Le 07/16, Laura Lazzati a écrit : > If you are interested, please, watch them > https://archive.org/details/guix-videos and give feedback here :) > We will appreciate it very much, and the idea is to collect the feedback up > to next Tuesday (July 23rd) Great videos! Excellent work! I should have watched them (especially the ones about packaging) before I submitted my first patch! ^_^' Cheers! -- Tanguy From mboxrd@z Thu Jan 1 00:00:00 1970 From: "pelzflorian (Florian Pelz)" Subject: Re: We need your feedback of the documentation videos! Date: Wed, 17 Jul 2019 09:55:12 +0200 Message-ID: <20190717075512.7h3fjuhmcrxydvcj@pelzflorian.localdomain> References: <87zhldmatl.fsf@teknik.io> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:35120) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hnemW-0006k2-Bn for guix-devel@gnu.org; Wed, 17 Jul 2019 03:55:21 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hnemU-0001KD-GP for guix-devel@gnu.org; Wed, 17 Jul 2019 03:55:20 -0400 Received: from pelzflorian.de ([5.45.111.108]:37024 helo=mail.pelzflorian.de) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hnemS-0001Hg-DZ for guix-devel@gnu.org; Wed, 17 Jul 2019 03:55:18 -0400 Content-Disposition: inline In-Reply-To: <87zhldmatl.fsf@teknik.io> List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: Dimakakos Dimos Cc: guix-devel@gnu.org On Wed, Jul 17, 2019 at 09:31:18AM +0300, Dimakakos Dimos wrote: > Also I think it would be nice to have a video that is about why guix > works this way and what are advantages of the ways it works. > +1 I believe why Guix is better than apt/flatpak/snap and how that is a benefit to users is an important question for attracting users from other GNU/Linux distros and such a video may be easier to watch than a talk. Regards, Florian From mboxrd@z Thu Jan 1 00:00:00 1970 From: Ricardo Wurmus Subject: Re: We need your feedback of the documentation videos! Date: Wed, 17 Jul 2019 11:44:09 +0200 Message-ID: <87d0i9gfme.fsf@elephly.net> References: Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:41146) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hngTz-0003dD-2a for guix-devel@gnu.org; Wed, 17 Jul 2019 05:44:20 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hngTx-0002ho-BA for guix-devel@gnu.org; Wed, 17 Jul 2019 05:44:19 -0400 Received: from sender4-of-o53.zoho.com ([136.143.188.53]:21381) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hngTw-0002gu-6j for guix-devel@gnu.org; Wed, 17 Jul 2019 05:44:17 -0400 In-reply-to: List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: Laura Lazzati Cc: guix-devel@gnu.org Hi Laura, > https://archive.org/details/guix-videos and give feedback here :) I second the praise these videos have received. I=E2=80=99m very happy to = see them close to completion. I haven=E2=80=99t watched all of them yet, but I noticed a couple of things while browsing them. Here are some comments about 01-installation-from-script: - at 01:15 the URL is broken in an odd manner. This can be fixed in one of these ways: a) use a shorter existing URL: https://git.sv.gnu.org/cgit/guix.git/plain/etc/guix-install.sh b) realize that the URL is still too long and create an alias at https://guix.gnu.org/install.sh and use that. - at 01:20 the GPG key is fetched from the SKS servers, which expose users to attacks. This should be replaced with the new method to fetch the GPG key. - at 01:30 Ludo=E2=80=99s name is mangled. Looks like an encoding problem. - at 01:35 the output has been altered. We are not using stars in the logo. What is the reason for altering the output? - at 02:00 the output looks odd=E2=80=A6 is the script really creating =E2=80=9C=E2=80=9D and then again =E2=80=9C=E2=80=9D? If this has been edited: why? - at 02:15 the way =E2=80=9C# yes=E2=80=9D is input would not work in real = life because =E2=80=9C# yes=E2=80=9D is not =E2=80=9Cyes=E2=80=9D. Is this a limitati= on of the video generation scripts? - at 02:20 it mentions ci.guix.info, but it should be ci.guix.gnu.org. - at 02:50 the command should probably be =E2=80=9Cguix install hello=E2=80= =9D instead of =E2=80=9Cguix package -i hello=E2=80=9D. - at the same mark there is a series of dots, which is not produced by Guix. Why have they been added? - at 02:55 the environment variable hint is outdated. Guix now prints something shorter. - at 3:10 the URL is printed in italics, which makes it harder to read. We should probably use =E2=80=9Chttps://guix.gnu.org/manual=E2=80=9D. Here are some comments about 02-everyday-use-part-one: - the command =E2=80=9Cguix package --install hello=E2=80=9D is used, but = =E2=80=9Cguix install hello=E2=80=9D might be better - the output refers to =E2=80=9Cci.guix.info=E2=80=9D, but it should be =E2=80=9Cci.guix.gnu.org=E2=80=9D. - the output is wrapped in an unfortunate place (right before the 100%) - we should replace the long store hashes with =E2=80=9C=E2=80=A6=E2=80=9D = so that fewer lines need to be wrapped around. - the environment variable hint is outdated. Guix displays something more concise now. - there are a bunch of dots before =E2=80=9C2 packages in profile=E2=80=9D,= which are not produced by Guix. - it=E2=80=99s confusing that it mentions =E2=80=9C2 packages=E2=80=9D beca= use we didn=E2=80=99t see anyone install the glibc-locales package. - at 2:58 there are two different fonts in use, but I can=E2=80=99t tell wh= y. The diagram also seems a little confusing to me. If it=E2=80=99s suppose= d to be read as a flow chart it would be better to use flow chart conventions. - at 4:03 the URL is printed in italics, which makes it harder to read. We should probably use =E2=80=9Chttps://guix.gnu.org/manual=E2=80=9D. Some comments about 02-everyday-use-part-two: - at 00:21 you show a URL to the previous video. I=E2=80=99d suggest remov= ing that as the URL is long and might change. - at 00:26 =E2=80=9Cguix pull=E2=80=9D appears twice, which is confusing. = I don=E2=80=99t know what the arrows mean. - at 01:01 I don=E2=80=99t understand why there is an arrow from =E2=80=9CG= arbage collector=E2=80=9D to =E2=80=9Cguix gc=E2=80=9D. They are the same. - at 02:21 there is again a series of dots, which are not produced by Guix. As mentioned before I suggest trimming the store hashes. - at 02:26 the URL should be https://guix.gnu.org/manual and not be printed in italics. Comments about the video 03-help: - at 00:20 the fonts and styles are mixed. Please don=E2=80=99t use all ca= ps. I also think it=E2=80=99s a bit =E2=80=A6 odd to self-advertise as =E2= =80=9Ckind=E2=80=9D and =E2=80=9Cwarm=E2=80=9D. (This may be true, but it=E2=80=99s for others to assess.) I would spell= out =E2=80=9CCoC=E2=80=9D because that may not mean much to people. - at 00:45 the URL is using a different font than the URL at the end of each video. It probably should be https://guix.gnu.org. - at 01:00 the URL for the manual is wrong. It should be https://guix.gnu.org/manual. - at 01:10 same comment about the font, italics, and the URL :) - 1:30 looks really crammed. I think it would be better to remove the header =E2=80=9COur website=E2=80=9D from all but the first mention of th= e website. There does not need to be a =E2=80=9Csection indicator=E2=80=9D on every = slide =E2=80=94 the videos are short enough to not need them. - at 2:20 =E2=80=9Csubscribing to a mailman=E2=80=9D sounds unintentionally= funny. I=E2=80=99d probably turn that into =E2=80=9CMailing lists=E2=80=9D or skip the heade= r completely. - at 3:05 same comment about the slide being a bit stuffed. There=E2=80=99= s too much on the slide. We could split that up into several slides or remove parts of it. - at 4:10 the URL should not be in italics and it should be https://guix.gnu.org What does everyone think about these points? -- Ricardo From mboxrd@z Thu Jan 1 00:00:00 1970 From: Laura Lazzati Subject: Re: We need your feedback of the documentation videos! Date: Tue, 30 Jul 2019 10:26:03 -0300 Message-ID: References: <87d0i9gfme.fsf@elephly.net> Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="0000000000006df5a2058ee5f519" Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:47819) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hsS9K-0005zp-Kj for guix-devel@gnu.org; Tue, 30 Jul 2019 09:26:43 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hsS9J-0000Qo-PJ for guix-devel@gnu.org; Tue, 30 Jul 2019 09:26:42 -0400 Received: from mail-wm1-x332.google.com ([2a00:1450:4864:20::332]:40419) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hsS9J-0000Pn-Ix for guix-devel@gnu.org; Tue, 30 Jul 2019 09:26:41 -0400 Received: by mail-wm1-x332.google.com with SMTP id v19so56681895wmj.5 for ; Tue, 30 Jul 2019 06:26:40 -0700 (PDT) In-Reply-To: <87d0i9gfme.fsf@elephly.net> List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: Ricardo Wurmus Cc: Guix-devel --0000000000006df5a2058ee5f519 Content-Type: text/plain; charset="UTF-8" Hi! Does anybody else want to say something about the videos? :) Regards! Laura --0000000000006df5a2058ee5f519 Content-Type: text/html; charset="UTF-8"
Hi!

Does anybody else want to say something about the videos? :)

Regards!
Laura


--0000000000006df5a2058ee5f519-- From mboxrd@z Thu Jan 1 00:00:00 1970 From: "pelzflorian (Florian Pelz)" Subject: Re: We need your feedback of the documentation videos! Date: Tue, 30 Jul 2019 16:06:47 +0200 Message-ID: <20190730140647.ve5sefo2qg4im2ax@pelzflorian.localdomain> References: <87d0i9gfme.fsf@elephly.net> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:56710) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hsSmF-0005xT-4P for guix-devel@gnu.org; Tue, 30 Jul 2019 10:06:55 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hsSmE-0004CQ-6d for guix-devel@gnu.org; Tue, 30 Jul 2019 10:06:55 -0400 Received: from pelzflorian.de ([5.45.111.108]:47518 helo=mail.pelzflorian.de) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hsSmC-00049w-5t for guix-devel@gnu.org; Tue, 30 Jul 2019 10:06:53 -0400 Content-Disposition: inline In-Reply-To: <87d0i9gfme.fsf@elephly.net> List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: Ricardo Wurmus Cc: guix-devel@gnu.org On Wed, Jul 17, 2019 at 11:44:09AM +0200, Ricardo Wurmus wrote: > - the command =E2=80=9Cguix package --install hello=E2=80=9D is used, b= ut =E2=80=9Cguix install > hello=E2=80=9D might be better >=20 On one hand, one understands that `guix package` does everything related to packages. That is nice. `guix install` is just an alias. But it is quicker to type. Regards, Florian From mboxrd@z Thu Jan 1 00:00:00 1970 From: "pelzflorian (Florian Pelz)" Subject: Re: We need your feedback of the documentation videos! Date: Tue, 30 Jul 2019 16:37:25 +0200 Message-ID: <20190730143725.hxqrfoxl4nz5bliv@pelzflorian.localdomain> References: <87zhldmatl.fsf@teknik.io> <20190717075512.7h3fjuhmcrxydvcj@pelzflorian.localdomain> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:35179) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hsTFr-0004wP-2q for guix-devel@gnu.org; Tue, 30 Jul 2019 10:37:31 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hsTFq-0003nc-1a for guix-devel@gnu.org; Tue, 30 Jul 2019 10:37:31 -0400 Received: from pelzflorian.de ([5.45.111.108]:47580 helo=mail.pelzflorian.de) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hsTFo-0003mM-56 for guix-devel@gnu.org; Tue, 30 Jul 2019 10:37:29 -0400 Received: from pelzflorian.localdomain (unknown [5.45.111.108]) by mail.pelzflorian.de (Postfix) with ESMTPSA id A15F0360035 for ; Tue, 30 Jul 2019 16:37:25 +0200 (CEST) Content-Disposition: inline In-Reply-To: <20190717075512.7h3fjuhmcrxydvcj@pelzflorian.localdomain> List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" Cc: guix-devel@gnu.org Also I believe how to add services on Guix System is something newcomers may struggle with and could use a video for, even though it is so much easier on Guix System than on other distros. Regards, Florian From mboxrd@z Thu Jan 1 00:00:00 1970 From: Tobias Geerinckx-Rice Subject: Re: We need your feedback of the documentation videos! Date: Tue, 30 Jul 2019 17:03:40 +0200 Message-ID: <87blxbftty.fsf@nckx> References: <87d0i9gfme.fsf@elephly.net> Mime-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha512; protocol="application/pgp-signature" Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:40390) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hsTfP-0000fg-0E for guix-devel@gnu.org; Tue, 30 Jul 2019 11:03:56 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hsTfL-0001hU-Tn for guix-devel@gnu.org; Tue, 30 Jul 2019 11:03:54 -0400 Received: from tobias.gr ([2001:470:7405::1]:54196) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hsTfJ-0001fW-Hn for guix-devel@gnu.org; Tue, 30 Jul 2019 11:03:51 -0400 In-reply-to: List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: guix-devel@gnu.org, Laura Lazzati --=-=-= Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: quoted-printable Laura, I've finally watched these videos and can only agree that they=20 look (and sound) very nice. I watched them with the archive.org=20 player in IceCat on a Guix System. Laura Lazzati =E5=86=99=E9=81=93=EF=BC=9A > Does anybody else want to say something about the videos? :) Some things I noticed and that (I think) Ricardo hasn't mentioned=20 yet. I know video is a lot of work, sorry for suggesting more. 01-installation-from-script: =2D 01:25 =E2=80=98The output tells us the signature is good.=E2=80=99 This made me chuckle: in typical GPG fashion, everything in its=20 output implies the opposite unless you're already familiar with=20 it. I realise it's far too late to touch the audio. Could we=20 highlight =E2=80=98public key =E2=80=A6 imported=E2=80=99 after half a se= cond or so?=20 I don't know if the scripts allow easy highlighting of output=20 text like that. =2D 01:35 and later: Our homepage has changed. Presumably as simple=20 as running a search & replace on the repo before the videos are=20 generated for the reals. 02-everyday-use-part-one: =2D 01:40 =E2=80=98we have our locales, that belong in the configuration of= =20 our system=E2=80=99 sounds wrong to me. Is it possible to cut after=20 =E2=80=98locales=E2=80=99? Or am I misunderstanding what is meant? =2D 02:40 There's enough space to have the =E2=80=98user=E2=80=99 type some= thing=20 like =E2=80=98guix install foobar:gui=E2=80=99 while talking about output= s=20 (without showing the result of that command). 02-everyday-use-part-two: =2D 0:25 =E2=80=98package/s=E2=80=99 needlessly caught my attention (I'd ex= pect=20 =E2=80=98package(s)=E2=80=99) but this might be a regional thing. Same f= or=20 =E2=80=98latest Guix version\ninstalled=E2=80=99 (=E2=80=98latest install= ed Guix=20 version=E2=80=99). =2D 0:25 I agree that the second =E2=80=98guix pull=E2=80=99 looks odd (and= =20 cramped). You could replace the vertical arrow with =E2=80=98&&=E2=80=99= or=20 add a =E2=80=98then=E2=80=99 as done in the next slide. =2D After dropping it, you'll have room to add =E2=80=98[regex]=E2=80=99 to= the=20 end of =E2=80=98guix package --upgrade=E2=80=99 and help combat a common= =20 misunderstanding :-) There's room even if you don't. All videos: =2D The empty line between commands and their output (but none the=20 between the output and the next command) looks strange to me.=20 There should either be no empty line (as in a real shell) or=20 another one before the next command for visual clarity. Now I need a break, because I'm that grumpy person who never=20 watches videos for technical information. Thank you, again, T G-R --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iHUEARYKAB0WIQT12iAyS4c9C3o4dnINsP+IT1VteQUCXUBcTAAKCRANsP+IT1Vt eSuLAP9AE7fFKeQdHbWP1cO4eGf8VrcGczYmU8eBRxjCkb5YGwD/VAnb6BFlAB3+ ZrWEroxybYsyxo26ylKsjxXfxHozSAI= =tQ52 -----END PGP SIGNATURE----- --=-=-=-- From mboxrd@z Thu Jan 1 00:00:00 1970 From: Tobias Geerinckx-Rice Subject: Re: We need your feedback of the documentation videos! Date: Tue, 30 Jul 2019 19:12:50 +0200 Message-ID: <878ssffnu5.fsf@nckx> References: <87d0i9gfme.fsf@elephly.net> <87blxbftty.fsf@nckx> Mime-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha512; protocol="application/pgp-signature" Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:58761) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hsVgG-0004DE-Ik for guix-devel@gnu.org; Tue, 30 Jul 2019 13:12:57 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hsVgF-0003bO-6n for guix-devel@gnu.org; Tue, 30 Jul 2019 13:12:56 -0400 Received: from tobias.gr ([2001:470:7405::1]:53444) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hsVgE-0003YY-Kb for guix-devel@gnu.org; Tue, 30 Jul 2019 13:12:55 -0400 In-reply-to: <87blxbftty.fsf@nckx> List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: guix-devel@gnu.org, Laura Lazzati --=-=-= Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: quoted-printable Laura, everyone, More badly-written notes from watching the other half of these=20 fine video shows. I'll try to submit some patches myself, if I=20 manage. Many are just me thinking aloud, not worth delaying a=20 release. 03-help: =2D 00:40 It's a shame that Paul made such a good job of reading our=20 old URL :-( All URLs in this video (and the others; fun!)=20 should be tested for 404s & 308s before releasing the videos,=20 although that's eminently scriptable. =2D 01:10 http://guix.gnu.org/help/ has changed.=20 http://guix.gnu.org/contact/ would now make a better screenshot=20 to match the audio at this timestamp. =2D 02:15 Was the title =E2=80=98subscribing to a mailman=E2=80=99 intentio= nal?=20 The conventional and boring choice would be =E2=80=98mailing list=E2=80= =99 or=20 just =E2=80=98list=E2=80=99. =2D 03:44 We can now add a =E2=80=98link=E2=80=99 to logs.guix.gnu.org, to = give=20 new users a sense of the place before they jump in, which can be=20 intimidating. Since this logging is not done by Freenode, I'd move it to the=20 bottom of the slide as its own top-level item. 04-packaging-part-one: =2D 00:13 This slide would be much easier to scan if both the arrows=20 and the commands were vertically aligned. =E2=80=98get=E2=80=99 should b= e=20 capitalised. =E2=80=98bootstrap=E2=80=99 is only ever run as =E2=80=98./= bootstrap=E2=80=99.=20 Let's write =E2=80=98./pre-inst-env=E2=80=99 as well since it's not in $P= ATH. In 02-everyday-use-part-two, commands like =E2=80=98guix install=E2=80=99 w= ere=20 set in the highly condensed sans-serif. The serif font used here=20 is a much better choice for commands (and more efficient than=20 monospace). Whatever the choice, I think it should be 100%=20 consistent across videos. 04-packaging-part-two: The file names should sort spontaneously, for examply by using=20 digits: 04-packaging-part-2. Even if this weren't an issue on=20 A/V.gnu.org, people may upload them elsewhere if we're lucky, and=20 04-packaging-part-three currently plays before this one. 00:30 =E2=80=98Using=E2=80=99 =E2=86=92 =E2=80=98Use=E2=80=99 to match the = rest. =E2=80=98i.e.=E2=80=99 should be =E2=80=98e.g.=E2=80=99, or drop it entirel= y because: =E2=80=98R=E2=80=99 =E2=86=92 =E2=80=98R packages=E2=80=99. If that really= can't be made to fit=20 we'll have to rewrite that; =E2=80=98R are=E2=80=99 doesn't work *and* soun= ds=20 silly. =2D 01:15 I'm afraid this could be taken as a joke. Maybe expand=20 the RHS of the =E2=80=98algorithm=E2=80=99 to include the steps later cov= ered=20 in part 3? They could be greyed out to show that we'll focus on=20 =E2=80=98guix import=E2=80=99 in this video. More =E2=80=98backwards=E2=80=99 font usage: serif text, sans-serif command. =2D 02:25 =E2=80=98open with a text editor <> file=E2=80=99 =E2=86=92 =E2= =80=98open the <> file=20 with a text editor=E2=80=99. Personally, I'd like to see =E2=80=98append alphabetically=E2=80=99 (or =E2= =80=98add=20 alphabetically=E2=80=99, since =E2=80=98append=E2=80=99 can be mistaken to = mean =E2=80=98at=20 the end=E2=80=99). The audio will still say =E2=80=98append=E2=80=99 but t= hat's all=20 right. 04-packaging-part-three: =2D 00:20 The difference between =E2=80=982) Check=E2=80=99 and =E2=80=983)= Test=E2=80=99 is not=20 clear to me. The audio doesn't explicitly mention these 4=20 steps. Using lone imperatives can be powerful, but these just=20 confuse me. *Maybe*: if we chose expand the =E2=80=98packaging algorithm=E2=80=99 in pa= rt 2,=20 we could re-use that here, with the other half greyed-out. There also appears to be an extra space before Test, but this=20 might not be there in the code. =2D 00:55 Apparent extra space before Check (which should be =E2=80=98Check= =20 for=E2=80=99), same for Gender in the next slide. This always seems to=20 happen on the 3rd item. Coincidence? The font rendering in general is just=E2=80=A6 off, but that's obviously=20 not your fault. Typo: =E2=80=98Gender-neutral=E2=80=99. Here, too, I find the =E2=80=98random=E2=80=99 arrow positioning and=20 inconsistent spacing (like =E2=80=98=C2=A0=C2=A0=C2=A0=C2=A0etc/=E2=80=99 a= t 01:50) a bit=20 distracting. Lists like these always sound so negative. I love the videos. T G-R --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iHUEARYKAB0WIQT12iAyS4c9C3o4dnINsP+IT1VteQUCXUB6kgAKCRANsP+IT1Vt eZ0KAPwPst3x7sfux6MNcTU9te7eAa0JPaqq+d5HgAKfCOAkZgEA+3Xlh7TRjq2C tabnTHLslBAL1Ov9BQs0N4kR8qzUJww= =Z+J3 -----END PGP SIGNATURE----- --=-=-=-- From mboxrd@z Thu Jan 1 00:00:00 1970 From: Laura Lazzati Subject: Re: We need your feedback of the documentation videos! Date: Thu, 8 Aug 2019 12:04:02 -0300 Message-ID: References: <87d0i9gfme.fsf@elephly.net> Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="00000000000074c92c058f9c608e" Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:34260) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hvjy6-0002py-Pi for guix-devel@gnu.org; Thu, 08 Aug 2019 11:04:44 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hvjy5-0007SQ-Dd for guix-devel@gnu.org; Thu, 08 Aug 2019 11:04:42 -0400 Received: from mail-wr1-x42a.google.com ([2a00:1450:4864:20::42a]:33505) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hvjy5-0007QZ-6e for guix-devel@gnu.org; Thu, 08 Aug 2019 11:04:41 -0400 Received: by mail-wr1-x42a.google.com with SMTP id n9so95393527wru.0 for ; Thu, 08 Aug 2019 08:04:40 -0700 (PDT) In-Reply-To: <87d0i9gfme.fsf@elephly.net> List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: Ricardo Wurmus Cc: Guix-devel --00000000000074c92c058f9c608e Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Hi! I will start fixing what we can from the videos :) Will be answering video by video to see what we can change and what we cannot unless we record again the transcript :/ 01-installation-from-script: - at 01:15 the URL is broken in an odd manner. This can be fixed in one of these ways: a) use a shorter existing URL: https://git.sv.gnu.org/cgit/guix.git/plain/etc/guix-install.sh b) realize that the URL is still too long and create an alias at https://guix.gnu.org/install.sh and use that. I will try using both links, if a) is still too long will make you know so that we create b). - at 01:20 the GPG key is fetched from the SKS servers, which expose users to attacks. This should be replaced with the new method to fetch the GPG key. - at 01:30 Ludo=E2=80=99s name is mangled. Looks like an encoding problem. Will install it from scratch again to fix the first issue, and as regards Ludo's name what I show was the output of fetching the key. Will go back to this after the installation. - at 01:35 the output has been altered. We are not using stars in the logo. What is the reason for altering the output? There was a kind of encoding issue, the actual logo was not being shown with the script so tried to fix it like that :/ - at 02:00 the output looks odd=E2=80=A6 is the script really creating =E2=80=9C=E2=80=9D and then again =E2=80=9C=E2=80=9D? If this has been edited: why? This is really a mistake :) To fix! - at 02:15 the way =E2=80=9C# yes=E2=80=9D is input would not work in real = life because =E2=80=9C# yes=E2=80=9D is not =E2=80=9Cyes=E2=80=9D. Is this a limitati= on of the video generation scripts? Don't get this very well, the # is just to show that the user is root, but we can remove it if it is confusing. - at 02:50 the command should probably be =E2=80=9Cguix install hello=E2=80= =9D instead of =E2=80=9Cguix package -i hello=E2=80=9D. Yes, the video is outdated since it was created. - at the same mark there is a series of dots, which is not produced by Guix. Why have they been added? This is done in most videos, they are used to kind of show that something goes in between but it is not relevant to show it. Do you have any other idea for that? - at 02:55 the environment variable hint is outdated. Guix now prints something shorter. Again outdated. - at 3:10 the URL is printed in italics, which makes it harder to read. We should probably use =E2=80=9Chttps://guix.gnu.org/manual=E2=80=9D. This is something to fix in all videos. Regards :) Laura --00000000000074c92c058f9c608e Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
Hi!
I will start fixing what we can fr= om the videos :) Will be answering video by video to see what we can change= and what we cannot unless we record again the transcript :/

=
01-installation-from-script:
- a= t 01:15 the URL is broken in an odd manner.=C2=A0 This can be fixed in one= =C2=A0 of these ways:
=C2=A0 = a) use a shorter existing URL:
=C2= =A0 https://git.sv.gnu.org/cgit/guix.git/plain/etc/guix-install.sh
<= /div>
=C2=A0 b) realize that the URL is stil= l too long and create an alias at
= =C2=A0 https://guix.gnu.org/ins= tall.sh and use that.
I will try using both links, if a) is still = too long will make you know so that we create b).

- at 01:20= the GPG key is fetched from the SKS servers, which expose
=C2=A0 users = to attacks.=C2=A0 This should be replaced with the new method to
=C2=A0 = fetch the GPG key.
- at 01:30 Ludo=E2=80=99s name is mangled.=C2=A0 Look= s like an encoding problem.
Will install it from scratch again to= fix the first issue, and as regards Ludo's name what I show was the ou= tput of fetching the key. Will go back to this after the installation.

= - at 01:35 the output has been altered.=C2=A0 We are not using stars in the=
=C2=A0 logo.=C2=A0 What is the reason for altering the output?
There was a kind of encoding issue, the actual logo was not bei= ng shown with the script so tried to fix it like that :/

- at 02:00 the= output looks odd=E2=80=A6 is the script really creating
=C2=A0 =E2=80= =9C<guixbuilder01 to 10>=E2=80=9D and then again =E2=80=9C<guixbui= lder08>=E2=80=9D?=C2=A0 If this has
=C2=A0 been edited: why?
Thi= s is really a mistake :) To fix!

- at 02:15 the way =E2=80=9C# yes=E2=80=9D is input would not wor= k in real life because
=C2=A0 =E2=80=9C# yes=E2=80=9D is not =E2=80=9Cye= s=E2=80=9D.=C2=A0 Is this a limitation of the video generation
=C2=A0 sc= ripts?
Don't get this very well, the # is just to s= how that the user is root, but we can remove it if it is confusing.
- at 02:50 the command should probably be= =E2=80=9Cguix install hello=E2=80=9D instead
=C2=A0 of =E2=80=9Cguix pa= ckage -i hello=E2=80=9D.
Yes, the video is outdated since i= t was created.

- at the s= ame mark there is a series of dots, which is not produced by
=C2=A0 Guix= .=C2=A0 Why have they been added?
This is done in most videos, they ar= e used to kind of show that something goes in between but it is not relevan= t to show it. Do you have any other idea for that?
- at 02:55 the environment variable hint is outdated.= =C2=A0 Guix now prints
=C2=A0 something shorter.
Again outdated.
- at 3:10 the URL is printed in= italics, which makes it harder to read.
=C2=A0 We should probably use = =E2=80=9Chttps://guix.gnu.org/manua= l=E2=80=9D.
This is something to fix in all videos.

Regards :)
Laura





--00000000000074c92c058f9c608e-- From mboxrd@z Thu Jan 1 00:00:00 1970 From: Ricardo Wurmus Subject: Re: We need your feedback of the documentation videos! Date: Thu, 08 Aug 2019 17:48:17 +0200 Message-ID: <87o90zwtdq.fsf@elephly.net> References: <87d0i9gfme.fsf@elephly.net> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:42234) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hvkeR-00054S-Ud for guix-devel@gnu.org; Thu, 08 Aug 2019 11:48:29 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hvkeQ-0004Kf-Qa for guix-devel@gnu.org; Thu, 08 Aug 2019 11:48:27 -0400 Received: from sender-of-o51.zoho.com ([135.84.80.216]:21284) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hvkeQ-0004JT-Bn for guix-devel@gnu.org; Thu, 08 Aug 2019 11:48:26 -0400 In-reply-to: List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: Laura Lazzati Cc: Guix-devel Hi Laura, > 01-installation-from-script: > - at 01:15 the URL is broken in an odd manner. This can be fixed in one > of these ways: > a) use a shorter existing URL: > https://git.sv.gnu.org/cgit/guix.git/plain/etc/guix-install.sh > b) realize that the URL is still too long and create an alias at > https://guix.gnu.org/install.sh and use that. > I will try using both links, if a) is still too long will make you know so > that we create b). We now have https://guix.gnu.org/install.sh. You are free to use it. > - at 01:35 the output has been altered. We are not using stars in the > logo. What is the reason for altering the output? > There was a kind of encoding issue, the actual logo was not being shown > with the script so tried to fix it like that :/ Can you tell me how to reproduce this? Prehaps it=E2=80=99s a problem with= our scripts? > - at 02:15 the way =E2=80=9C# yes=E2=80=9D is input would not work in rea= l life because > =E2=80=9C# yes=E2=80=9D is not =E2=80=9Cyes=E2=80=9D. Is this a limita= tion of the video generation > scripts? > Don't get this very well, the # is just to show that the user is root, but > we can remove it if it is confusing. It is confusing, because the user is not supposed to execute the =E2=80=9Cy= es=E2=80=9D command but just to answer =E2=80=9Cyes=E2=80=9D to the question =E2=80=94 = on the same line. > - at the same mark there is a series of dots, which is not produced by > Guix. Why have they been added? > This is done in most videos, they are used to kind of show that something > goes in between but it is not relevant to show it. Do you have any other > idea for that? I=E2=80=99d prefer either a simple ellipsis (=E2=80=9C=E2=80=A6=E2=80=9D) o= r the actual console output. -- Ricardo From mboxrd@z Thu Jan 1 00:00:00 1970 From: Laura Lazzati Subject: Re: We need your feedback of the documentation videos! Date: Tue, 13 Aug 2019 15:03:29 -0300 Message-ID: References: <87d0i9gfme.fsf@elephly.net> <87o90zwtdq.fsf@elephly.net> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="0000000000006e5dea059003773f" Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:41059) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hxb9X-00028g-2H for guix-devel@gnu.org; Tue, 13 Aug 2019 14:04:12 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hxb9V-0000pN-Jb for guix-devel@gnu.org; Tue, 13 Aug 2019 14:04:11 -0400 Received: from mail-wm1-x332.google.com ([2a00:1450:4864:20::332]:55952) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hxb9V-0000nW-9j for guix-devel@gnu.org; Tue, 13 Aug 2019 14:04:09 -0400 Received: by mail-wm1-x332.google.com with SMTP id f72so2330207wmf.5 for ; Tue, 13 Aug 2019 11:04:08 -0700 (PDT) In-Reply-To: <87o90zwtdq.fsf@elephly.net> List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: Ricardo Wurmus Cc: Guix-devel --0000000000006e5dea059003773f Content-Type: multipart/alternative; boundary="0000000000006e5de7059003773d" --0000000000006e5de7059003773d Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Hi! We now have https://guix.gnu.org/install.sh. You are free to use it. > Uhm I am getting a 404 for this link :/ > > Can you tell me how to reproduce this? Prehaps it=E2=80=99s a problem wi= th our > scripts? > I am attaching the cliSession file (cannot copy/paste it here, it gets broken). You have to generate the cli video, inside the root video directory, with ` ./create-cli-video.sh 01-installation-from-script en_US firstCli 1`. I get question mark symbols instead of the logo, that is why I changed it for *s. Don't pay attention to the mismatch between the audio and the video, it is something to solve later. > > It is confusing, because the user is not supposed to execute the =E2=80= =9Cyes=E2=80=9D > command but just to answer =E2=80=9Cyes=E2=80=9D to the question =E2=80= =94 on the same line. > OK, I removed the #, the 'yes' is still in a newline, is that too bad? > > I=E2=80=99d prefer either a simple ellipsis (=E2=80=9C=E2=80=A6=E2=80=9D)= or the actual console output. > OK, will change it for that :) As regards what Tobias said: "- 01:25 =E2=80=98The output tells us the signature is good.=E2=80=99 This made me chuckle: in typical GPG fashion, everything in its output implies the opposite unless you're already familiar with it. I realise it's far too late to touch the audio. Could we highlight =E2=80=98public key =E2=80=A6 imported=E2=80=99 after half a se= cond or so? I don't know if the scripts allow easy highlighting of output text like that." Yes, unluckily we should record again the audio to change that. There is still work to do regarding colouring the output. I don't know what the others would like to do (if publishing the videos with the output as it is, or waiting until improving that) Regards :) Laura --0000000000006e5de7059003773d Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
Hi!

We now have https://guix.gnu.org/install.sh.=C2=A0 You are free t= o use it.
Uhm I am getting a 404 for this link :/
=

Can you tell me how to reproduce this?=C2=A0 Prehaps it=E2=80=99s a problem= with our
scripts?
I am attaching the cliSession file (cannot co= py/paste it here, it gets broken). You have to generate the cli video, insi= de the root video directory, with ` ./create-cli-video.sh 01-installation-f= rom-script en_US firstCli 1`. I get=C2=A0 question mark symbols instead of = the logo, that is why I changed it for *s. Don't pay attention to the m= ismatch between the audio and the video, it is something to solve later.

It is confusing, because the user is not supposed to execute the =E2=80=9Cy= es=E2=80=9D
command but just to answer =E2=80=9Cyes=E2=80=9D to the question =E2=80=94 = on the same line.
OK, I removed the #,=C2=A0 the '= yes' is still in a newline, is that too bad?=C2=A0

I=E2=80=99d prefer either a simple ellipsis (=E2=80=9C=E2=80=A6=E2=80=9D) o= r the actual console output.
OK, will change it for th= at :)

As regards what Tobias said:
"- 01:25 =E2=80=98The output tells us the s= ignature is good.=E2=80=99
=C2=A0 This made me chuckle: in typical GPG f= ashion, everything in its
=C2=A0 output implies the opposite unless you&= #39;re already familiar with
=C2=A0 it.=C2=A0 I realise it's far too= late to touch the audio.=C2=A0 Could we
=C2=A0 highlight =E2=80=98publi= c key =E2=80=A6 imported=E2=80=99 after half a second or so?
=C2=A0 I do= n't know if the scripts allow easy highlighting of output
=C2=A0text= like that."
Yes, unluckily we should record again the audio to c= hange that. There is still work to do regarding colouring the output. I don= 't know what the others would like to do (if publishing the videos with= the output as it is, or waiting until improving that)

Regards :)
Laura=
--0000000000006e5de7059003773d-- --0000000000006e5dea059003773f Content-Type: application/octet-stream; name=firstCli Content-Disposition: attachment; filename=firstCli Content-Transfer-Encoding: base64 Content-ID: X-Attachment-Id: f_jza4vo9s0 IzpzbGVlcCAxMDAwCiM6dHlwZVJvb3QgMjQgd2dldCBodHRwczovL2d1aXguZ251Lm9yZy9pbnN0 YWxsLnNoCiM6c2xlZXAgNjAwMAojOnR5cGVSb290IDI0IHdnZXQgaHR0cHM6Ly9zdi5nbnUub3Jn L3Blb3BsZS92aWV3Z3BnLnBocD91c2VyX2lkPTE1MTQ1CiM6dHlwZU5vUHJvbXB0IDI0IC1xTyAt IHwgZ3BnIC0taW1wb3J0IC0KIzpzbGVlcCAyMDAwCiM6cHJpbnQgZ3BnOiBrZXkgMDkwQjExOTkz RDlBRUJCNTogMTI0IHNpZ25hdHVyZXMgbm90IGNoZWNrZWQgZHVlIHRvCiM6cHJpbnQgbWlzc2lu ZyBrZXlzCiM6cHJpbnQgZ3BnOiBrZXkgMDkwQjExOTkzRDlBRUJCNTogcHVibGljIGtleSAiTHVk b3ZpYyBDb3VydMOocwojOnByaW50IDxsdWRvQGdudS5vcmc+IiBpbXBvcnRlZAojOnByaW50IGdw Zzogbm8gdWx0aW1hdGVseSB0cnVzdGVkIGtleXMgZm91bmQKIzpwcmludCBncGc6IFRvdGFsIG51 bWJlciBwcm9jZXNzZWQ6IDEKIzpwcmludCBncGc6ICAgICAgICAgICAgICAgaW1wb3J0ZWQ6IDEK IzpzbGVlcCAxMDAwCiM6c2xlZXAgNTUwMAojOnR5cGVSb290IDI2IGJhc2ggZ3VpeC1pbnN0YWxs LnNoCiM6c2xlZXAgMTAwMAojOnByaW50ICAgIOKWkeKWkeKWkSAgICAgICAgICAgICAgICAgICAg ICAgICAgICAgICAgICAgICDilpHilpHilpEKIzpwcmludCAgICAg4paR4paR4paS4paS4paR4paR 4paR4paR4paR4paR4paR4paR4paRICAgICAgICAgICAgICAg4paR4paR4paR4paR4paR4paR4paR 4paR4paR4paS4paS4paR4paRCiM6cHJpbnQgICAgICDilpHilpHilpLilpLilpLilpLilpLilpHi lpHilpHilpHilpHilpHilpEgICAgICAgICAgIOKWkeKWkeKWkeKWkeKWkeKWkeKWkeKWkuKWkuKW kuKWkuKWkuKWkQojOnByaW50ICAgICAgICAgIOKWkeKWkuKWkuKWkuKWkeKWkeKWkuKWkuKWkuKW kuKWkiAgICAgICAgIOKWkeKWkeKWkeKWkeKWkeKWkeKWkeKWkuKWkuKWkQojOnByaW50ICAgICAg ICAgICAgICAgIOKWkeKWkuKWkuKWkuKWkuKWkSAgICAgICDilpHilpHilpHilpHilpHilpEKIzpw cmludCAgICAgICAgICAgICAgICAg4paS4paS4paS4paS4paSICAgICAg4paR4paR4paR4paR4paR 4paRCiM6cHJpbnQgICAgICAgICAgICAgICAgICDilpLilpLilpLilpLilpIgICAgIOKWkeKWkeKW keKWkeKWkQojOnByaW50ICAgICAgICAgICAgICAgICAg4paR4paS4paS4paS4paS4paSICAg4paR 4paR4paR4paR4paRCiM6cHJpbnQgICAgICAgICAgICAgICAgICAg4paS4paS4paS4paS4paSICAg 4paR4paR4paR4paR4paRCiM6cHJpbnQgICAgICAgICAgICAgICAgICAgIOKWkuKWkuKWkuKWkuKW kiDilpHilpHilpHilpHilpEKIzpwcmludCAgICAgICAgICAgICAgICAgICAg4paR4paS4paS4paS 4paS4paS4paR4paR4paR4paRCiM6cHJpbnQgICAgICAgICAgICAgICAgICAgICDilpLilpLilpLi lpLilpLilpLilpHilpHilpEKIzpwcmludCAgICAgICAgICAgICAgICAgICAgICDilpLilpLilpLi lpLilpLilpLilpEKIzpwcmludCAgICAgIF9fX19fIF8gICBfIF8gICAgXyAgICBfX19fXyAgICAg ICBfCiM6cHJpbnQgICAgIC8gX19fX3wgXCB8IHwgfCAgfCB8ICAvIF9fX198ICAgICAoXykKIzpw cmludCAgICB8IHwgIF9ffCAgXHwgfCB8ICB8IHwgfCB8ICBfXyBfICAgXyBfX18gIF9fCiM6cHJp bnQgICAgfCB8IHxfIHwgLiAnIHwgfCAgfCB8IHwgfCB8XyB8IHwgfCB8IFwgXC8gLwojOnByaW50 ICAgIHwgfF9ffCB8IHxcICB8IHxfX3wgfCB8IHxfX3wgfCB8X3wgfCB8PiAgPAojOnByaW50ICAg ICBcX19fX198X3wgXF98XF9fX18vICAgXF9fX19ffFxfXyxffF8vXy9cX1wKIzpuZXdsaW5lCiM6 cHJpbnQgVGhpcyBzY3JpcHQgaW5zdGFsbHMgR05VIEd1aXggb24geW91ciBzeXN0ZW0KIzpuZXds aW5lCiM6c2xlZXAgMTAwMAojOnByaW50IGh0dHBzOi8vd3d3LmdudS5vcmcvc29mdHdhcmUvZ3Vp eC8KIzpzbGVlcCAyMDAwCiM6cHJpbnQgUHJlc3MgcmV0dXJuIHRvIGNvbnRpbnVlLgojOnNsZWVw IDUwMDAKIzpwcmludCBTdGFydGluZyBpbnN0YWxsYXRpb24gCiM6cHJpbnQgWyBQQVNTIF0gdmVy aWZpY2F0aW9uIG9mIHJlcXVpcmVkIGNvbW1hbmRzIGNvbXBsZXRlZAojOnByaW50IFsgSU5GTyBd IGluaXQgc3lzdGVtIGlzOiBzeXN0ZW1kCiM6c2xlZXAgMTAwMAojOnByaW50IFsgSU5GTyBdIHN5 c3RlbSBpcyB4ODZfNjQtbGludXgKIzpwcmludCBbIFBBU1MgXSBSZWxlYXNlIGZvciB5b3VyIHN5 c3RlbTogZ3VpeC1iaW5hcnktMS4wLjEueDg2XzY0LWxpbnV4CiM6c2xlZXAgMTAwMAojOnByaW50 IFsgSU5GTyBdIERvd25sb2FkaW5nIEd1aXggcmVsZWFzZSBhcmNoaXZlCiM6c2xlZXAgMTAwMAoj OnByaW50IFsgUEFTUyBdIGRvd25sb2FkIGNvbXBsZXRlZC4KIzpwcmludCBbIFBBU1MgXSBTaWdu YXR1cmUgaXMgdmFsaWQuCiM6cHJpbnQgWyBQQVNTIF0gdW5wYWNrZWQgYXJjaGl2ZQojOnNsZWVw IDM1MDAKIzpwcmludCBbIElORk8gXSBJbnN0YWxsaW5nIC92YXIvZ3VpeCBhbmQgL2dudS4uLgoj OnNsZWVwIDEwMDAKIzpwcmludCBbIElORk8gXSBMaW5raW5nIHRoZSByb290IHVzZXIncyBwcm9m aWxlCiM6cHJpbnQgWyBQQVNTIF0gYWN0aXZhdGVkIHJvb3QgcHJvZmlsZSBhdCAvcm9vdC8uY29u ZmlnL2d1aXgvY3VycmVudAojOnNsZWVwIDE1MDAKIzpwcmludCBbIFBBU1MgXSBncm91cCA8Z3Vp eGJ1aWxkPiBjcmVhdGVkCiM6c2xlZXAgMTAwMAojOnByaW50IFsgUEFTUyBdIHVzZXIgYWRkZWQg PGd1aXhidWlsZGVyMDEgdG8gMTA+CiM6c2xlZXAgNTAwCiM6cHJpbnQgQ3JlYXRlZCBzeW1saW5r IC9ldGMvc3lzdGVtZC9zeXN0ZW0vbXVsdGktdXNlci50YXJnZXQud2FudHMvCiM6cHJpbnQgZ3Vp eC1kYWVtb24uc2VydmljZSDihpIgL2V0Yy9zeXN0ZW1kL3N5c3RlbS9ndWl4LWRhZW1vbi5zZXJ2 aWNlLgojOnNsZWVwIDUwMAojOnByaW50IFsgUEFTUyBdIGVuYWJsZWQgR3VpeCBkYWVtb24gdmlh IHN5c3RlbWQKIzpzbGVlcCAxMDAwCiM6cHJpbnQgWyBJTkZPIF0gbWFraW5nIHRoZSBndWl4IGNv bW1hbmQgYXZhaWxhYmxlIHRvIG90aGVyIHVzZXJzCiM6c2xlZXAgMTAwMDAKIzpwcmludCBQZXJt aXQgZG93bmxvYWRpbmcgcHJlLWJ1aWx0IHBhY2thZ2UgYmluYXJpZXMgZnJvbSB0aGUgcHJvamVj dCdzCiM6cHJpbnQgYnVpbGQgZmFybXM/ICh5ZXMvbm8pCiM6c2xlZXAgMTAwMDAKIzp0eXBlTm9Q cm9tcHQgNTUgeWVzCiM6c2xlZXAgNDAwMAojOnByaW50IFsgUEFTUyBdIEF1dGhvcml6ZWQgcHVi bGljIGtleSBmb3IgY2kuZ3VpeC5nbnUub3JnCiM6c2xlZXAgMjAwMAojOnByaW50IFsgSU5GTyBd IGNsZWFuaW5nIHVwIC90bXAvZ3VpeC5mY3YKIzpzbGVlcCAxMDAwCiM6cHJpbnQgWyBQQVNTIF0g R3VpeCBoYXMgc3VjY2Vzc2Z1bGx5ICBiZWVuIGluc3RhbGxlZCEKIzpwcmludCBbIElORk8gXSBS dW4gJ2luZm8gZ3VpeCcgdG8gcmVhZCB0aGUgbWFudWFsLgojOnNsZWVwIDMwMDAK --0000000000006e5dea059003773f-- From mboxrd@z Thu Jan 1 00:00:00 1970 From: Laura Lazzati Subject: Re: We need your feedback of the documentation videos! Date: Sun, 25 Aug 2019 15:55:16 -0300 Message-ID: References: <87d0i9gfme.fsf@elephly.net> <87o90zwtdq.fsf@elephly.net> Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="000000000000ac897b0590f5967a" Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:60284) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1i1xgC-0003kl-2J for guix-devel@gnu.org; Sun, 25 Aug 2019 14:55:57 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1i1xgB-0000b5-3B for guix-devel@gnu.org; Sun, 25 Aug 2019 14:55:55 -0400 Received: from mail-wm1-x32c.google.com ([2a00:1450:4864:20::32c]:53227) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1i1xgA-0000aZ-Tl for guix-devel@gnu.org; Sun, 25 Aug 2019 14:55:55 -0400 Received: by mail-wm1-x32c.google.com with SMTP id o4so13408401wmh.2 for ; Sun, 25 Aug 2019 11:55:54 -0700 (PDT) In-Reply-To: List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: Ricardo Wurmus Cc: Guix-devel --000000000000ac897b0590f5967a Content-Type: text/plain; charset="UTF-8" Hi Guix! I've uploaded a new version of the video for asking for help. Here is the link to it: https://archive.org/details/guix-videos/03-help-new-version.webm I guess I took into account all the suggestions from Ricardo and Tobias, but I would appreciate feedback again :) Kind regards :) Laura --000000000000ac897b0590f5967a Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
Hi Guix!

I've uploaded a= new version of the video for asking for help. Here is the link to it: ht= tps://archive.org/details/guix-videos/03-help-new-version.webm

I guess I took into account all the suggestions from Ricar= do and Tobias, but I would appreciate feedback again :)

Kind regards :)
Laura
--000000000000ac897b0590f5967a-- From mboxrd@z Thu Jan 1 00:00:00 1970 From: "pelzflorian (Florian Pelz)" Subject: Re: We need your feedback of the documentation videos! Date: Thu, 17 Oct 2019 06:34:04 +0200 Message-ID: <20191017043403.hwv77ripwbrzco54@pelzflorian.localdomain> References: <87d0i9gfme.fsf@elephly.net> <87o90zwtdq.fsf@elephly.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:50890) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iKxUG-0004Yo-NC for guix-devel@gnu.org; Thu, 17 Oct 2019 00:34:10 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iKxUF-0006mj-Db for guix-devel@gnu.org; Thu, 17 Oct 2019 00:34:08 -0400 Received: from pelzflorian.de ([5.45.111.108]:50168 helo=mail.pelzflorian.de) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1iKxUE-0006ls-UI for guix-devel@gnu.org; Thu, 17 Oct 2019 00:34:07 -0400 Content-Disposition: inline In-Reply-To: List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: Laura Lazzati Cc: Guix-devel On Sun, Aug 25, 2019 at 03:55:16PM -0300, Laura Lazzati wrote: > Hi Guix! > > I've uploaded a new version of the video for asking for help. Here is the > link to it: https://archive.org/details/guix-videos/03-help-new-version.webm > > I guess I took into account all the suggestions from Ricardo and Tobias, > but I would appreciate feedback again :) > > Kind regards :) > Laura What is the status on these videos? Have they received feedback yet? Please someone review and publish and blog about them before the next Guix release. They would be useful for Guix to grow, I think. Regards, Florian From mboxrd@z Thu Jan 1 00:00:00 1970 From: =?utf-8?Q?Ludovic_Court=C3=A8s?= Subject: Re: We need your feedback of the documentation videos! Date: Sat, 19 Oct 2019 22:13:59 +0200 Message-ID: <8736fov6go.fsf@gnu.org> References: <87d0i9gfme.fsf@elephly.net> <87o90zwtdq.fsf@elephly.net> <20191017043403.hwv77ripwbrzco54@pelzflorian.localdomain> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:49890) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iLv6w-0006BK-69 for guix-devel@gnu.org; Sat, 19 Oct 2019 16:14:03 -0400 In-Reply-To: <20191017043403.hwv77ripwbrzco54@pelzflorian.localdomain> (pelzflorian@pelzflorian.de's message of "Thu, 17 Oct 2019 06:34:04 +0200") List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: "pelzflorian (Florian Pelz)" Cc: Guix-devel Hello! "pelzflorian (Florian Pelz)" skribis: > On Sun, Aug 25, 2019 at 03:55:16PM -0300, Laura Lazzati wrote: >> Hi Guix! >>=20 >> I've uploaded a new version of the video for asking for help. Here is the >> link to it: https://archive.org/details/guix-videos/03-help-new-version.= webm >>=20 >> I guess I took into account all the suggestions from Ricardo and Tobias, >> but I would appreciate feedback again :) >>=20 >> Kind regards :) >> Laura > > What is the status on these videos? Have they received feedback yet? > Please someone review and publish and blog about them before the next > Guix release. They would be useful for Guix to grow, I think. I think so too! As is too often the case, I haven=E2=80=99t allocated as m= uch bandwidth to that as I wanted, but if you wanted to integrate them on the web site, I think that=E2=80=99d be great. Especially since we now host the web site by ourselves, we could also host the videos there, so that can be pretty easy to do. WDYT? Ludo=E2=80=99. From mboxrd@z Thu Jan 1 00:00:00 1970 From: "pelzflorian (Florian Pelz)" Subject: Re: We need your feedback of the documentation videos! Date: Sat, 19 Oct 2019 23:00:34 +0200 Message-ID: <20191019210034.elopd6mhzq2dinxl@pelzflorian.localdomain> References: <87d0i9gfme.fsf@elephly.net> <87o90zwtdq.fsf@elephly.net> <20191017043403.hwv77ripwbrzco54@pelzflorian.localdomain> <8736fov6go.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:53523) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iLvq1-0004nq-Ue for guix-devel@gnu.org; Sat, 19 Oct 2019 17:00:39 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iLvq0-0007kZ-UR for guix-devel@gnu.org; Sat, 19 Oct 2019 17:00:37 -0400 Content-Disposition: inline In-Reply-To: <8736fov6go.fsf@gnu.org> List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: Ludovic =?utf-8?Q?Court=C3=A8s?= Cc: Guix-devel On Sat, Oct 19, 2019 at 10:13:59PM +0200, Ludovic Court=C3=A8s wrote: > [=E2=80=A6] if you wanted to integrate them on > the web site, I think that=E2=80=99d be great. >=20 I suppose the =E2=80=9CDiscover Guix=E2=80=9D section on the homepage sho= uld advertise Guix System and the videos, maybe in buttons next to the ALL PACKAGES button. I will look at making a proposal next week. I am nowhere near as creative as the website=E2=80=99s authors, so maybe others will t= hink of better designs. > Especially since we now host the web site by ourselves, we could also > host the videos there, so that can be pretty easy to do. >=20 > WDYT? >=20 > Ludo=E2=80=99. I cannot judge whether audio-video.gnu.org is better or worse than berlin. Regards, Florian From mboxrd@z Thu Jan 1 00:00:00 1970 From: "pelzflorian (Florian Pelz)" Subject: Re: We need your feedback of the documentation videos! Date: Tue, 22 Oct 2019 14:05:04 +0200 Message-ID: <20191022120504.7cyoc5x2exylpzrg@pelzflorian.localdomain> References: <87d0i9gfme.fsf@elephly.net> <87o90zwtdq.fsf@elephly.net> <20191017043403.hwv77ripwbrzco54@pelzflorian.localdomain> <8736fov6go.fsf@gnu.org> <20191019210034.elopd6mhzq2dinxl@pelzflorian.localdomain> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="fhrbse2gicyszos7" Content-Transfer-Encoding: 7bit Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:49915) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iMsud-0000oj-K9 for guix-devel@gnu.org; Tue, 22 Oct 2019 08:05:30 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iMsuS-0001V0-Pd for guix-devel@gnu.org; Tue, 22 Oct 2019 08:05:19 -0400 Content-Disposition: inline In-Reply-To: <20191019210034.elopd6mhzq2dinxl@pelzflorian.localdomain> List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: Ludovic =?utf-8?Q?Court=C3=A8s?= Cc: Guix-devel --fhrbse2gicyszos7 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable OAOn Sat, Oct 19, 2019 at 11:00:34PM +0200, pelzflorian (Florian Pelz) wr= ote: > On Sat, Oct 19, 2019 at 10:13:59PM +0200, Ludovic Court=C3=A8s wrote: > > [=E2=80=A6] if you wanted to integrate them on > > the web site, I think that=E2=80=99d be great. > >=20 >=20 > I suppose the =E2=80=9CDiscover Guix=E2=80=9D section on the homepage s= hould advertise > Guix System and the videos, maybe in buttons next to the ALL PACKAGES > button. I will look at making a proposal next week. I am nowhere > near as creative as the website=E2=80=99s authors, so maybe others will= think > of better designs. >=20 >=20 Do you have in mind something like the attached patch? It does not yet add all of the videos; this is more proof of concept-like. > > Especially since we now host the web site by ourselves, we could also > > host the videos there, so that can be pretty easy to do. > >=20 > > WDYT? > >=20 > > Ludo=E2=80=99. >=20 > I cannot judge whether audio-video.gnu.org is better or worse than > berlin. >=20 Putting the video files in the guix-artwork git repository may be wrong, so the patch does not do that yet, instead still referencing archive.org which seems wrong too. Regards, Florian --fhrbse2gicyszos7 Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="0001-website-Use-needed-modules-in-posts.patch" >From eb38b985f3c8bddd9abef94256e398a395d29965 Mon Sep 17 00:00:00 2001 From: Florian Pelz Date: Tue, 22 Oct 2019 13:15:07 +0200 Subject: [PATCH 1/2] website: Use needed modules in posts. * website/posts/back-from-seagl-2018.sxml: Use needed modules. --- website/posts/back-from-seagl-2018.sxml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/website/posts/back-from-seagl-2018.sxml b/website/posts/back-from-seagl-2018.sxml index c5ad0a9..958369f 100644 --- a/website/posts/back-from-seagl-2018.sxml +++ b/website/posts/back-from-seagl-2018.sxml @@ -1,6 +1,7 @@ (begin (use-modules (apps base templates components) - (srfi srfi-19)) + (apps base utils) + (srfi srfi-19)) `((title . "Back from SeaGL 2018") (author . "Chris Marusich") (date . ,(make-date 0 0 0 0 10 12 2018 -28800)) -- 2.23.0 --fhrbse2gicyszos7 Content-Type: text/plain; charset=utf-8 Content-Disposition: attachment; filename="0002-wip-website-Add-documentation-videos.patch" Content-Transfer-Encoding: quoted-printable >From e1f3352ac249faf6a3c6ac82a5b2498550656708 Mon Sep 17 00:00:00 2001 From: Florian Pelz Date: Tue, 22 Oct 2019 13:36:46 +0200 Subject: [PATCH 2/2] [wip] website: Add documentation videos. * website/static/videos/img/everyday-use-01.png: New file. * website/static/videos/img/everyday-use-02.png: New file. * website/static/videos/img/installation-from-script.png: New file. * website/apps/videos/data.scm: New file. * website/apps/videos/types.scm: New file. * website/apps/videos/utils.scm: New file. * website/apps/videos/templates/components.scm: New file. * website/apps/videos/templates/video-list.scm: New file. * website/apps/videos/templates/video.scm: New file. * website/apps/videos/builder.scm: New file. * website/haunt.scm (site): Add the builder. * website/apps/base/templates/components.scm (navbar): Add to navbar. * website/static/base/css/navbar.css: Increase size at which website switches to mobile mode. * website/apps/base/templates/home.scm (home-t): Reference videos in Discover Guix section. --- website/apps/base/templates/components.scm | 1 + website/apps/base/templates/home.scm | 8 ++- website/apps/videos/builder.scm | 65 +++++++++++++++++ website/apps/videos/data.scm | 46 ++++++++++++ website/apps/videos/templates/components.scm | 30 ++++++++ website/apps/videos/templates/video-list.scm | 46 ++++++++++++ website/apps/videos/templates/video.scm | 50 +++++++++++++ website/apps/videos/types.scm | 66 ++++++++++++++++++ website/apps/videos/utils.scm | 19 +++++ website/haunt.scm | 2 + website/static/base/css/navbar.css | 2 +- website/static/videos/img/everyday-use-01.png | Bin 0 -> 102437 bytes website/static/videos/img/everyday-use-02.png | Bin 0 -> 120292 bytes .../videos/img/installation-from-script.png | Bin 0 -> 91881 bytes 14 files changed, 333 insertions(+), 2 deletions(-) create mode 100644 website/apps/videos/builder.scm create mode 100644 website/apps/videos/data.scm create mode 100644 website/apps/videos/templates/components.scm create mode 100644 website/apps/videos/templates/video-list.scm create mode 100644 website/apps/videos/templates/video.scm create mode 100644 website/apps/videos/types.scm create mode 100644 website/apps/videos/utils.scm create mode 100644 website/static/videos/img/everyday-use-01.png create mode 100644 website/static/videos/img/everyday-use-02.png create mode 100644 website/static/videos/img/installation-from-script.pn= g diff --git a/website/apps/base/templates/components.scm b/website/apps/ba= se/templates/components.scm index d3f6af1..ac3cd7b 100644 --- a/website/apps/base/templates/components.scm +++ b/website/apps/base/templates/components.scm @@ -294,6 +294,7 @@ ,(menu-item #:label "Download" #:active-item active-item #:url (gu= ix-url "download/")) ,(menu-item #:label "Packages" #:active-item active-item #:url (gu= ix-url "packages/")) ,(menu-item #:label "Blog" #:active-item active-item #:url (guix-u= rl "blog/")) + ,(menu-item #:label "Videos" #:active-item active-item #:url (guix= -url "videos/")) ,(menu-item #:label "Help" #:active-item active-item #:url (guix-u= rl "help/")) ,(menu-item #:label "Donate" #:active-item active-item #:url (guix= -url "donate/")) =20 diff --git a/website/apps/base/templates/home.scm b/website/apps/base/tem= plates/home.scm index 5cb3bf5..6a856ca 100644 --- a/website/apps/base/templates/home.scm +++ b/website/apps/base/templates/home.scm @@ -117,7 +117,13 @@ ,@(map screenshot->shtml (context-datum context "screenshots"))) =20 (div - (@ (class "action-box centered-text")) + (@ (class "fields-box")) + + ,(button-big + #:label "VIDEOS" + #:url (guix-url "videos/") + #:light #true) + " " ,(button-big #:label "ALL PACKAGES" #:url (guix-url "packages/") diff --git a/website/apps/videos/builder.scm b/website/apps/videos/builde= r.scm new file mode 100644 index 0000000..2a42220 --- /dev/null +++ b/website/apps/videos/builder.scm @@ -0,0 +1,65 @@ +;;; GNU Guix web site +;;; Copyright =C2=A9 2019 Florian Pelz +;;; Initially written by sirgazil who waives all +;;; copyright interest on this file. + +(define-module (apps videos builder) + #:use-module (apps aux web) + #:use-module (apps videos data) + #:use-module (apps videos templates video) + #:use-module (apps videos templates video-list) + #:use-module (apps videos utils) + #:use-module (haunt html) + #:use-module (haunt page) + #:use-module (haunt utils) + #:use-module (srfi srfi-1) + #:export (builder)) + + +;;; +;;; Application builder. +;;; + +(define (builder site posts) + "Return the list of web resources that compose the app. + + This procedure is a Haunt builder procedure. + + SITE () + A site object that defines all the properties of the website. See + Haunt objects for more information. + + POSTS (list of ) + A list of post objects that represent articles from the blog. See + Haunt objects for more information. + + RETURN (list of ) + A list of page objects that represent the web resources of the + application. See Haunt objects for more information." + (flatten + (list (video-list-builder) + (videos-builder)))) + +;;; +;;; Helper builders. +;;; + +(define (videos-builder) + "Return a list of Haunt pages representing videos." + (map-in-order + (lambda (playlist) + (map-in-order + (lambda (previous video next) + (make-page (video->url video) + (video-t previous video next) + sxml->html)) + (cons #f (drop-right playlist 1)) + playlist + (append (cdr playlist) '(#f)))) + playlists)) + +(define (video-list-builder) + "Return a Haunt page displaying all videos." + (make-page (url-path-join "videos" "index.html") + (video-list-t) + sxml->html)) diff --git a/website/apps/videos/data.scm b/website/apps/videos/data.scm new file mode 100644 index 0000000..db11c98 --- /dev/null +++ b/website/apps/videos/data.scm @@ -0,0 +1,46 @@ +;;; GNU Guix web site +;;; Copyright =C2=A9 2019 Florian Pelz +;;; Initially written by sirgazil who waves all +;;; copyright interest on this file. + +(define-module (apps videos data) + #:use-module (apps base utils) + #:use-module (apps videos types) + #:use-module (srfi srfi-19) + #:export (playlists)) + + +;;; +;;; Data. +;;; + + +(define playlists + ;; List of "playlists" of related videos in proper order. + (list + (list + (video + #:title "Installation from Script" + #:description + '(p "Explains how to install Guix on distributions not running +GNU Guix.") + #:url "https://archive.org/download/guix-videos/01-installation-fro= m-script.webm" + #:poster (guix-url "static/videos/img/installation-from-script.png"= ) + #:last-updated (string->date "2019-10-21T20:00:00" "~Y-~m-~dT~H:~M:= ~S"))) + (list + (video + #:title "Everyday use of GNU Guix, Part One" + #:description + '(p "Shows you how to install packages and how to manage software +package generations.") + #:url "https://archive.org/download/guix-videos/02-everyday-use-par= t-one.webm" + #:poster (guix-url "static/videos/img/everyday-use-01.png") + #:last-updated (string->date "2019-10-21T20:00:00" "~Y-~m-~dT~H:~M:= ~S")) + (video + #:title "Everyday use of GNU Guix, Part Two" + #:description + '(p "Shows you how to upgrade software and how to reclaim storage +space.") + #:url "https://archive.org/download/guix-videos/02-everyday-use-par= t-two.webm" + #:poster (guix-url "static/videos/img/everyday-use-02.png") + #:last-updated (string->date "2019-10-21T20:00:00" "~Y-~m-~dT~H:~M:= ~S"))))) diff --git a/website/apps/videos/templates/components.scm b/website/apps/= videos/templates/components.scm new file mode 100644 index 0000000..fc9f916 --- /dev/null +++ b/website/apps/videos/templates/components.scm @@ -0,0 +1,30 @@ +;;; GNU Guix web site +;;; Copyright =C2=A9 2019 Florian Pelz +;;; Initially written by sirgazil who waves all +;;; copyright interest on this file. + +(define-module (apps videos templates components) + #:use-module (apps base templates components) + #:use-module (apps videos types) + #:use-module (srfi srfi-19) + #:export (video-content)) + + +(define (video-content video) + `((div + (video + (@ (class "video-preview") + (src ,(video-url video)) + (poster ,(video-poster video)) + (controls "controls")) + (p + "Download video: " + ,(link-yellow + #:label (video-title video) + #:url (video-url video)) + " (1 minute, 30 seconds)."))) + ,(video-description video) + ,(let ((date (video-last-updated video))) + (if date + `(p "Last updated: " ,(date->string date)) + "")))) diff --git a/website/apps/videos/templates/video-list.scm b/website/apps/= videos/templates/video-list.scm new file mode 100644 index 0000000..7847225 --- /dev/null +++ b/website/apps/videos/templates/video-list.scm @@ -0,0 +1,46 @@ +;;; GNU Guix web site +;;; Copyright =C2=A9 2019 Florian Pelz +;;; Initially written by sirgazil who waves all +;;; copyright interest on this file. + +(define-module (apps videos templates video-list) + #:use-module (apps base templates components) + #:use-module (apps base templates theme) + #:use-module (apps base types) + #:use-module (apps base utils) + #:use-module (apps videos data) + #:use-module (apps videos templates components) + #:use-module (apps videos types) + #:use-module (apps videos utils) + #:export (video-list-t)) + + +(define (video-list-t) + "Return a list of videos in SHTML." + (theme + #:title '("Videos") + #:description + "Video about GNU Guix." + #:keywords + '("GNU" "Linux" "Unix" "Free software" "Libre software" + "Operating system" "GNU Hurd" "GNU Guix package manager" + "Help resources" "Videos") + #:active-menu-item "Videos" + #:css (list + (guix-url "static/base/css/page.css") + (guix-url "static/base/css/index.css")) + #:crumbs (list (crumb "Videos" (guix-url "videos/"))) + #:content + `(main + (@ (class "page centered-block limit-width")) + ,(map-in-order + (lambda (playlist) + `(,(map-in-order + (lambda (video) + `((h2 ,(link-yellow + #:label (video-title video) + #:url (guix-url (video->url video)))) + ,(video-content video))) + playlist) + ,(horizontal-separator))) + playlists)))) diff --git a/website/apps/videos/templates/video.scm b/website/apps/video= s/templates/video.scm new file mode 100644 index 0000000..1737178 --- /dev/null +++ b/website/apps/videos/templates/video.scm @@ -0,0 +1,50 @@ +;;; GNU Guix web site +;;; Copyright =C2=A9 2019 Florian Pelz +;;; Initially written by sirgazil who waves all +;;; copyright interest on this file. + +(define-module (apps videos templates video) + #:use-module (apps base templates components) + #:use-module (apps base templates theme) + #:use-module (apps base types) + #:use-module (apps base utils) + #:use-module (apps videos templates components) + #:use-module (apps videos types) + #:use-module (apps videos utils) + #:export (video-t)) + + +(define (video-t previous video next) + "Return a page in SHTML for the given VIDEO. If true, links to the +PREVIOUS and NEXT videos are added." + (theme + #:title (list "Video" (video-title video)) + #:description + "Video about GNU Guix." + #:keywords + '("GNU" "Linux" "Unix" "Free software" "Libre software" + "Operating system" "GNU Hurd" "GNU Guix package manager" + "Help resources" "Videos") + #:active-menu-item "Videos" + #:css (list + (guix-url "static/base/css/page.css") + (guix-url "static/base/css/index.css")) + #:crumbs (list (crumb "Videos" (guix-url "videos/")) + (crumb (video-title video) "./")) + #:content + `(main + (@ (class "page centered-block limit-width")) + (h2 ,(video-title video)) + ,(video-content video) + ,(if previous + `(div + ,(link-yellow + #:label "=E2=86=90 Previous" + #:url (guix-url (video->url previous)))) + "") + ,(if next + `(div + ,(link-yellow + #:label "Next =E2=86=92" + #:url (guix-url (video->url next)))) + "")))) diff --git a/website/apps/videos/types.scm b/website/apps/videos/types.sc= m new file mode 100644 index 0000000..ababb44 --- /dev/null +++ b/website/apps/videos/types.scm @@ -0,0 +1,66 @@ +;;; GNU Guix web site +;;; Copyright =C2=A9 2019 Florian Pelz +;;; Initially written by sirgazil who waves all +;;; copyright interest on this file. + +(define-module (apps videos types) + #:use-module (srfi srfi-9) + #:export (video + video? + video-description + video-last-updated + video-poster + video-title + video-url)) + + +;;; +;;; Data types. +;;; + +;;; Video (record type) +;;; --------------------- +;;; +;;; A video object represents something viewable in an HTML video +;;; element and accessible from the videos list on the website. +;;; +;;; Objects of this type can be created with the "video" procedure as +;;; well (see Helper procedures below). +;;; +;;; Fields: +;;; +;;; title (string) +;;; The full name of the video. For example: +;;; "Everyday use of GNU Guix, Part One". +;;; +;;; description (SXML) +;;; A short description. For example: +;;; '(p "Shows you how to install packages and how to manage +;;; software package generations."). +;;; +;;; url (string) +;;; A URL to the video file. +;;; +;;; poster (string) +;;; A URL to a representative preview image for the video. +;;; +;;; last-updated (date) +;;; Optional SRFI-19 upload date of the video file's most recent +;;; version, or #f. This should be specified for videos that +;;; possibly become outdated over time such as documentation videos. +;;; +(define-record-type