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----- --=-=-=--