Re: We need your feedback of the documentation videos!

[Ricardo Wurmus <rekado@elephly.net>]

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’s a problem with our
scripts?

> - at 02:15 the way “# yes” is input would not work in real life because
>   “# yes” is not “yes”.  Is this a limitation 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 “yes”
command but just to answer “yes” to the question — 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’d prefer either a simple ellipsis (“…”) or the actual console output.

--
Ricardo