From mboxrd@z Thu Jan 1 00:00:00 1970 From: Laura Lazzati Subject: Re: GNU Guix Video Documentation Date: Sat, 27 Oct 2018 21:32:54 -0300 Message-ID: References: <20181025235334.7ebf5970@alma-ubu> <87efcd5oqn.fsf@elephly.net> <20181026120004.5b99860c@alma-ubu> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:36875) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gGZ1K-00059U-5l for guix-devel@gnu.org; Sat, 27 Oct 2018 20:33:35 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gGZ1I-0008RO-VK for guix-devel@gnu.org; Sat, 27 Oct 2018 20:33:34 -0400 Received: from mail-pg1-x533.google.com ([2607:f8b0:4864:20::533]:43811) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1gGZ1I-0008Qk-PR for guix-devel@gnu.org; Sat, 27 Oct 2018 20:33:32 -0400 Received: by mail-pg1-x533.google.com with SMTP id n10-v6so2174583pgv.10 for ; Sat, 27 Oct 2018 17:33:32 -0700 (PDT) In-Reply-To: <20181026120004.5b99860c@alma-ubu> 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: =?UTF-8?B?QmrDtnJuIEjDtmZsaW5n?= Cc: Guix-devel , Ricardo Wurmus Hi! I have some ideas, suggestions and questions, based on this two videos that someone replied in one thread of mails when I was first getting in touch with the community. [1] https://media.libreplanet.org/u/libreplanet/m/practical-verifiable-soft= ware-freedom-with-guixsd/ [2] https://archive.fosdem.org/2018/schedule/event/usingguix/ I don't know much about video editing in the technical aspect of if, but maybe my ideas could help. I have been reading about some concepts, however. On Fri, Oct 26, 2018 at 7:02 AM Bj=C3=B6rn H=C3=B6fling wrote: > > 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 mos= t > > 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. Here, the first question, I would ask myself is: what is the purpose of the video and who the audience of the video is? It is not the same making a general video promoting guix with it's features and conveying ideas to users/sysadmins/contributors - even different kind of contributors - than doing so to people that are already interested in using, applying guix, or contributing and want to know the technical aspects because they prefer to have a first approach with them and then read the documentation. > 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). When I first read the Ourteachy project, I thought that the videos had to be technical, showing howtos, as Bjorn mentioned. But for the first case (promoting, conveying ideas, to any of the people the audience involves) maybe screencasting is more appealing to the person that is watching them. It comes to my mind having someone speaking, and showing graphics, diagrams, something like [1] - now I realize that I have always watched screencasted tutorials and courses and most of them in English. Translation in this case is more difficult, it is true. > > 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! Yes, I was thinking at first Are you planning to translate them to specific languages, or to as many as possible, even on demand, in the future? > > 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. As regards the technical/howto ones, I was thinking also of something like this. Some slides for the concepts with then cli sessions. > > 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. Where are all the videos already created for guix and guixSD, apart from [1] and [2] and the one on the official site? Having this answered, maybe it is clearer which videos are needed the most, the ones conveying ideas, the technical ones, or if both, which ones are more important. > > 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. GN= U Guix does not > > currently have its own Mediagoblin instance. > > We don't have a Mediagoblin package yet :-) > > Bj=C3=B6rn Regards! Laura