all messages for Guix-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Tobias Geerinckx-Rice <me@tobias.gr>
To: guix-devel@gnu.org, Laura Lazzati <laura.lazzati.15@gmail.com>
Subject: Re: We need your feedback of the documentation videos!
Date: Tue, 30 Jul 2019 17:03:40 +0200	[thread overview]
Message-ID: <87blxbftty.fsf@nckx> (raw)
In-Reply-To: <CAPNLzUP+RZZ+w3q3ERZoLH0+4Ab7y41ZxhNgNQ2Y2=Gp3LSFfg@mail.gmail.com>

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

Laura,

I've finally watched these videos and can only agree that they 
look (and sound) very nice.  I watched them with the archive.org 
player in IceCat on a Guix System.

Laura Lazzati 写道:
> Does anybody else want to say something about the videos? :)

Some things I noticed and that (I think) Ricardo hasn't mentioned 
yet.  I know video is a lot of work, sorry for suggesting more.

01-installation-from-script:
- 01:25 ‘The output tells us the signature is good.’
  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 ‘public key … imported’ after half a second or so? 
  I don't know if the scripts allow easy highlighting of output 
  text like that.
- 01:35 and later: Our homepage has changed.  Presumably as simple 
  as running a search & replace on the repo before the videos are 
  generated for the reals.

02-everyday-use-part-one:
- 01:40 ‘we have our locales, that belong in the configuration of 
  our system’ sounds wrong to me.  Is it possible to cut after 
  ‘locales’?  Or am I misunderstanding what is meant?
- 02:40 There's enough space to have the ‘user’ type something 
  like ‘guix install foobar:gui’ while talking about outputs 
  (without showing the result of that command).

02-everyday-use-part-two:
- 0:25 ‘package/s’ needlessly caught my attention (I'd expect 
  ‘package(s)’) but this might be a regional thing.  Same for 
  ‘latest Guix version\ninstalled’ (‘latest installed Guix 
  version’).
- 0:25 I agree that the second ‘guix pull’ looks odd (and 
  cramped).  You could replace the vertical arrow with ‘&&’ or 
  add a ‘then’ as done in the next slide.
- After dropping it, you'll have room to add ‘[regex]’ to the 
  end of ‘guix package --upgrade’ and help combat a common 
  misunderstanding :-)  There's room even if you don't.

All videos:
- The empty line between commands and their output (but none the 
  between the output and the next command) looks strange to me. 
  There should either be no empty line (as in a real shell) or 
  another one before the next command for visual clarity.

Now I need a break, because I'm that grumpy person who never 
watches videos for technical information.

Thank you, again,

T G-R

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

  reply	other threads:[~2019-07-30 15:03 UTC|newest]

Thread overview: 33+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2019-07-16 15:11 We need your feedback of the documentation videos! Laura Lazzati
2019-07-16 17:40 ` pelzflorian (Florian Pelz)
2019-07-17  6:31 ` Dimakakos Dimos
2019-07-17  7:55   ` pelzflorian (Florian Pelz)
2019-07-30 14:37     ` pelzflorian (Florian Pelz)
2019-07-17  7:11 ` Tanguy Le Carrour
2019-07-17  9:44 ` Ricardo Wurmus
2019-07-30 13:26   ` Laura Lazzati
2019-07-30 15:03     ` Tobias Geerinckx-Rice [this message]
2019-07-30 17:12       ` Tobias Geerinckx-Rice
2019-07-30 14:06   ` pelzflorian (Florian Pelz)
2019-08-08 15:04   ` Laura Lazzati
2019-08-08 15:48     ` Ricardo Wurmus
2019-08-13 18:03       ` Laura Lazzati
2019-08-25 18:55         ` Laura Lazzati
2019-10-17  4:34           ` pelzflorian (Florian Pelz)
2019-10-19 20:13             ` Ludovic Courtès
2019-10-19 21:00               ` pelzflorian (Florian Pelz)
2019-10-22 12:05                 ` pelzflorian (Florian Pelz)
2019-10-22 16:25                   ` sirgazil
2019-10-22 18:59                     ` pelzflorian (Florian Pelz)
2019-10-23 11:49                       ` pelzflorian (Florian Pelz)
2019-10-23 14:33                         ` sirgazil
2019-10-25  6:35                       ` pelzflorian (Florian Pelz)
2019-10-25  8:12                         ` pelzflorian (Florian Pelz)
2019-10-25 14:25                           ` sirgazil
2019-10-25 20:32                         ` Ludovic Courtès
2019-10-25 21:58                           ` pelzflorian (Florian Pelz)
2019-10-26 14:29                             ` pelzflorian (Florian Pelz)
2019-10-27 19:47                               ` sirgazil
2019-10-28  7:41                                 ` pelzflorian (Florian Pelz)
2019-10-28  7:41                                   ` [bug#37947] " pelzflorian (Florian Pelz)
2019-10-28 20:28                                   ` bug#37947: " pelzflorian (Florian Pelz)

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=87blxbftty.fsf@nckx \
    --to=me@tobias.gr \
    --cc=guix-devel@gnu.org \
    --cc=laura.lazzati.15@gmail.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/guix.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.