From mboxrd@z Thu Jan  1 00:00:00 1970
From: Julien Lepiller <julien@lepiller.eu>
Subject: Re: GNU Guix Video Documentation discussing priorities
Date: Mon, 29 Oct 2018 12:00:23 +0100
Message-ID: <3d9a4bff314e69fd14d39ddff8fe1338@lepiller.eu>
References: <CAE4v=pgjkHpciW-aw3xPrt6fYeb6s8n7WmE_W3wrwN+Cu3roDw@mail.gmail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=UTF-8;
 format=flowed
Content-Transfer-Encoding: 8bit
Return-path: <guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:42189)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <julien@lepiller.eu>) id 1gH5Hw-0003VQ-2e
	for guix-devel@gnu.org; Mon, 29 Oct 2018 07:00:56 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <julien@lepiller.eu>) id 1gH5Hg-0001qj-JM
	for guix-devel@gnu.org; Mon, 29 Oct 2018 07:00:44 -0400
Received: from lepiller.eu ([2a00:5884:8208::1]:35444)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <julien@lepiller.eu>) id 1gH5Hg-0001YY-77
	for guix-devel@gnu.org; Mon, 29 Oct 2018 07:00:36 -0400
Received: from webmail.lepiller.eu (static-176-182-42-79.ncc.abo.bbox.fr
	[176.182.42.79]) by lepiller.eu (OpenSMTPD) with ESMTPSA id 00b8380b
	(TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256:NO)
	for <guix-devel@gnu.org>; Mon, 29 Oct 2018 10:59:11 +0000 (UTC)
In-Reply-To: <CAE4v=pgjkHpciW-aw3xPrt6fYeb6s8n7WmE_W3wrwN+Cu3roDw@mail.gmail.com>
List-Id: "Development of GNU Guix and the GNU System distribution."
	<guix-devel.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/guix-devel>,
	<mailto:guix-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/guix-devel/>
List-Post: <mailto:guix-devel@gnu.org>
List-Help: <mailto:guix-devel-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/guix-devel>,
	<mailto:guix-devel-request@gnu.org?subject=subscribe>
Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org
Sender: "Guix-devel" <guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org>
To: guix-devel@gnu.org

Le 2018-10-29 08:53, Gábor Boskovits a écrit :
> Hello Guix,
> 
> Regarding the Outreachy Project for Creating Video Documentation for 
> GNU Guix,
> we come to a point where we should set up the priorities:
> 1. What types of videos should be created first:
> a. introducing concepts,
> b. practical howtos.
> 2. What audience to target:
> a. people not yet interested in guix
> b. people new to guix
> c. users
> d. developers.
> 3. What topics to cover first.
> 
> Please feel free to add to the list above, if you feel anything is 
> missing.
> Any suggestions are welcome.
> 
> Best regards,
> g_bor

I think we should focus on more practical howtos aimed at people new to 
guix. So
our priority would be “installing guix on a foreign distro”, “installing 
guixsd”
and “using guix: installing, upgrading and removing packages” (including 
guix pull).
Maybe "guix gc" should get a video too.

I can also think of other video titles like “environments vs profiles” 
(showing the
difference between the two with practical examples) which would be aimed 
at
developpers (not guix developpers, developpers of other things) (it 
could be
“developping on guixsd”). “Getting back to work” when something is 
wrong, show how
to roll-back a package profile, a system profile or even guix itself.

Thoughts?