From mboxrd@z Thu Jan  1 00:00:00 1970
From: =?UTF-8?Q?G=C3=A1bor_Boskovits?= <boskovits@gmail.com>
Subject: Re: GNU Guix Video Documentation discussing priorities
Date: Mon, 19 Nov 2018 13:09:14 +0100
Message-ID: <CAE4v=pj3dt4f0APcGojJtJ8_h6utTtmdpLmi7BpyzuaN0n5Jog@mail.gmail.com>
References: <CAE4v=pgjkHpciW-aw3xPrt6fYeb6s8n7WmE_W3wrwN+Cu3roDw@mail.gmail.com>
	<3d9a4bff314e69fd14d39ddff8fe1338@lepiller.eu>
	<CAPNLzUPyZ_WV3QVi=q_ExNmZANAXSNbkGWeFrjFiesZ5nYBPDw@mail.gmail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset="UTF-8"
Return-path: <guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:53127)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <boskovits@gmail.com>) id 1gOiMs-0002BA-Ku
	for guix-devel@gnu.org; Mon, 19 Nov 2018 07:09:31 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <boskovits@gmail.com>) id 1gOiMq-0003Na-5S
	for guix-devel@gnu.org; Mon, 19 Nov 2018 07:09:28 -0500
Received: from mail-io1-xd2d.google.com ([2607:f8b0:4864:20::d2d]:40528)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <boskovits@gmail.com>) id 1gOiMp-0003MI-UE
	for guix-devel@gnu.org; Mon, 19 Nov 2018 07:09:28 -0500
Received: by mail-io1-xd2d.google.com with SMTP id n9so2240935ioh.7
	for <guix-devel@gnu.org>; Mon, 19 Nov 2018 04:09:27 -0800 (PST)
In-Reply-To: <CAPNLzUPyZ_WV3QVi=q_ExNmZANAXSNbkGWeFrjFiesZ5nYBPDw@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: Laura Lazzati <laura.lazzati.15@gmail.com>
Cc: Guix-devel <guix-devel@gnu.org>

Hello guix!

Now that we have our intern announced I would like to bring this
thread back to life.

So 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.

What we have so far:

Based on Julien's suggestions:
* Focus on more practical howtos aimed at people new to guix.
** installing guix on a foreign distro
** installing guixsd
** using guix: installing, upgrading and removing packages
** guix pull
** MAYBE guix gc
* Developers (not guix, but general devs)
** environments vs profiles
** developing on guixsd
** "getting back to work" when something goes wrong
** roll-back profile, system-profile, guix

Additional questions based on Laura's suggestions:
* Should we aim some videos at contributors?
* Should we create videos related to getting help or troubleshooting?

Please feel free to add to the list above, if you feel anything is missing.
Any suggestions are welcome.

Best regards,
g_bor