unofficial mirror of guix-devel@gnu.org 
 help / color / mirror / code / Atom feed
* GNU Guix Video Documentation discussing priorities
@ 2018-10-29  7:53 Gábor Boskovits
  2018-10-29 11:00 ` Julien Lepiller
  0 siblings, 1 reply; 6+ messages in thread
From: Gábor Boskovits @ 2018-10-29  7:53 UTC (permalink / raw)
  To: Guix-devel, Laura Lazzati, Björn Höfling,
	Ricardo Wurmus, Ludovic Courtès, Ricardo Wurmus

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

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: GNU Guix Video Documentation discussing priorities
  2018-10-29  7:53 GNU Guix Video Documentation discussing priorities Gábor Boskovits
@ 2018-10-29 11:00 ` Julien Lepiller
  2018-10-29 16:59   ` Laura Lazzati
  0 siblings, 1 reply; 6+ messages in thread
From: Julien Lepiller @ 2018-10-29 11:00 UTC (permalink / raw)
  To: guix-devel

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?

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: GNU Guix Video Documentation discussing priorities
  2018-10-29 11:00 ` Julien Lepiller
@ 2018-10-29 16:59   ` Laura Lazzati
  2018-11-19 12:09     ` Gábor Boskovits
  0 siblings, 1 reply; 6+ messages in thread
From: Laura Lazzati @ 2018-10-29 16:59 UTC (permalink / raw)
  To: julien; +Cc: Guix-devel

[-- Attachment #1: Type: text/plain, Size: 840 bytes --]

On Mon, Oct 29, 2018 at 8:01 AM Julien Lepiller <julien@lepiller.eu> wrote:

>
> I think we should focus on more practical howtos aimed at people new to
> guix

So, first question: 1b.

> our priority would be “installing guix on a foreign distro”, “installing
> guixsd
>
For 3: Installation mentioned in Outreachy site would be the first video

> and “using guix: installing, upgrading and removing packages” (including
> guix pull).
> Maybe "guix gc" should get a video too.
>
For 3: Daily use as user the second one.

>
>   “developping on guixsd”).
>
 Then 2:
b, but applied to c and d. Aren't contributors going to be taken into
account?

What about the videos asking for help, troubleshooting? I believe they
apply to everyone, regardless the audience they belong to.

>
> Thoughts?
>
>

[-- Attachment #2: Type: text/html, Size: 1666 bytes --]

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: GNU Guix Video Documentation discussing priorities
  2018-10-29 16:59   ` Laura Lazzati
@ 2018-11-19 12:09     ` Gábor Boskovits
  2018-11-20 22:37       ` Björn Höfling
  0 siblings, 1 reply; 6+ messages in thread
From: Gábor Boskovits @ 2018-11-19 12:09 UTC (permalink / raw)
  To: Laura Lazzati; +Cc: Guix-devel

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

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: GNU Guix Video Documentation discussing priorities
  2018-11-19 12:09     ` Gábor Boskovits
@ 2018-11-20 22:37       ` Björn Höfling
  2018-11-21 12:45         ` Laura Lazzati
  0 siblings, 1 reply; 6+ messages in thread
From: Björn Höfling @ 2018-11-20 22:37 UTC (permalink / raw)
  To: Gábor Boskovits; +Cc: Guix-devel

[-- Attachment #1: Type: text/plain, Size: 1175 bytes --]

Hi Gábor,

On Mon, 19 Nov 2018 13:09:14 +0100
Gábor Boskovits <boskovits@gmail.com> wrote:

> 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

I have nothing to add to that list.

Björn

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 181 bytes --]

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: GNU Guix Video Documentation discussing priorities
  2018-11-20 22:37       ` Björn Höfling
@ 2018-11-21 12:45         ` Laura Lazzati
  0 siblings, 0 replies; 6+ messages in thread
From: Laura Lazzati @ 2018-11-21 12:45 UTC (permalink / raw)
  To: Björn Höfling; +Cc: Guix-devel

[-- Attachment #1: Type: text/plain, Size: 117 bytes --]

Great! I am open to new suggestions based on what is better for the
project, as I mentioned before.
Regards :)
Laura

[-- Attachment #2: Type: text/html, Size: 228 bytes --]

^ permalink raw reply	[flat|nested] 6+ messages in thread

end of thread, other threads:[~2018-11-21 12:46 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2018-10-29  7:53 GNU Guix Video Documentation discussing priorities Gábor Boskovits
2018-10-29 11:00 ` Julien Lepiller
2018-10-29 16:59   ` Laura Lazzati
2018-11-19 12:09     ` Gábor Boskovits
2018-11-20 22:37       ` Björn Höfling
2018-11-21 12:45         ` Laura Lazzati

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/guix.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).