From mboxrd@z Thu Jan 1 00:00:00 1970 From: =?UTF-8?B?QmrDtnJuIEjDtmZsaW5n?= Subject: Re: GNU Guix Video Documentation Date: Fri, 26 Oct 2018 12:00:04 +0200 Message-ID: <20181026120004.5b99860c@alma-ubu> References: <20181025235334.7ebf5970@alma-ubu> <87efcd5oqn.fsf@elephly.net> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; boundary="Sig_/Kyv8AP8nfIg0s.U+l.P+xr2"; protocol="application/pgp-signature" Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:58491) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gFyux-0001b8-TT for guix-devel@gnu.org; Fri, 26 Oct 2018 06:00:41 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gFyue-0000tP-O6 for guix-devel@gnu.org; Fri, 26 Oct 2018 06:00:26 -0400 Received: from m4s11.vlinux.de ([83.151.27.109]:48146 helo=bjoernhoefling.de) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gFyue-0000pm-3t for guix-devel@gnu.org; Fri, 26 Oct 2018 06:00:16 -0400 In-Reply-To: <87efcd5oqn.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 , Ricardo Wurmus --Sig_/Kyv8AP8nfIg0s.U+l.P+xr2 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable On Fri, 26 Oct 2018 06:13:52 +0200 Ricardo Wurmus wrote: > While screencasts can be useful, I don=E2=80=99t think they are the most > useful tool to convey ideas. Much of what=E2=80=99s special about Guix is > not the command line user interface, but the underlying ideas. These > are better illustrated, I think, with the help of graphics as we have > been doing for years when introducing Guix to new audiences. I thought the videos are not for transporting general ideas, but to show the daily usage of guix. And that is using the command line. By showing common tasks the general idea gets transported (i.e. while showing guix package -i, guix package --list-generations, guix package --roll-back the idea of transactional package management is conveyed, without much abstract words). > One concern is also translations and future updates. Recording a > terminal session with screencasting software makes it impossible for > us to easily translate the video. When command line interactions are > to be shown I=E2=80=99d prefer to have a way to reproduce / regenerate the > output in a different locale automatically, i.e. using scripts. When I thought about translations, I thought only about the speech and subtitles. Of cause you are right, the command line should be localized too! =20 > We can easily mix what amounts to a narrated slideshow with scripted > command line sessions (cf asciicasts). This can easily be automated, > so that we can rebuild the video and update it with minimal effort to > prevent it from getting stale. When I said screencasts I first thought of handmade ones within well prepared (and documented) environments and a script/stage directions and script for automatic cutouts from the raw recordings. Then I thought of this puppet we have for qemu-tests: Is it possible to use it in order to controll the virtual machine, screencast it and get back certain events like terminal keywords in order to start/stop/pause the cast? This is my first time I heard of asciicasts. You mean the program asciinema and it's protocol asciicasts (https://asciinema.org/)? That looks cool. Can it be used to produce rendered films too? Automating the process as much as possible is a good idea. Can we get that bitwise reproducible? :-) [..] > We can host the videos on http://audio-video.gnu.org/ and embed them > on the Guix website, but the sources should be added to the > guix-artwork repository, I think. Yes, that site looks good, I watched videos from it in the past. > The videos could also be published on Mediagoblin instances, but I > don=E2=80=99t know if there=E2=80=99s an instance for GNU packages. GNU = Guix does not > currently have its own Mediagoblin instance. We don't have a Mediagoblin package yet :-) Bj=C3=B6rn --Sig_/Kyv8AP8nfIg0s.U+l.P+xr2 Content-Type: application/pgp-signature Content-Description: OpenPGP digital signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 iEYEARECAAYFAlvS5aUACgkQvyhstlk+X/3BQgCgkjDFHeakAcSdar67M2ft12Hh BT8AmwdnOTctI3u2gj3auIoJomxDLkKl =tQ1m -----END PGP SIGNATURE----- --Sig_/Kyv8AP8nfIg0s.U+l.P+xr2--