Hello,
Hi Laura,
I'm pulling this again on guix-devel. We have only two weeks left in
this Outreachy round and Gábor and I decided to focus on two things:
1) Get the videos-repository filled up with the general tools and
Makefiles from your private repository.
2) Get as much as possible video-templates in, even if they are only
80% polished.
[3) Get the blog-post online.]
How does that sound to you?
For everybody: The guix-video repository is now created:
git clone https://git.savannah.gnu.org/git/guix/videos.git
Though it is yet empty :-)
Concerning the repository:
0) I would prefer to have a linar history on master that is more or
less clean. What you could do is add the general scripts to the
'master', then create for each video a branch as Gábor suggested.
I would NOT MERGE them, but REBASE: If something on master changes, you
would rebase the video-branch on master (and force-push to the
repository). If that branch is more-or-less settled, you can finally do
an interactive rebase: 'git rebase -i master' if any commits can be
melted or cleaned up. Finally you can rebase master to that video-branch
and have a nice linear history. Rebase the other video-branches to your
new master.
As the development of the "general" part and the "video-specific" part
are in separate directories, there shouldn't be any merge conflicts.
1) In the end, in this guix-video repository there should be both the
general framework things (i.e. the Makefile, the script tool, the
general README, and maybe some other things). These should be generally
usable, nothing video-specific should be there.
Then there should be for each video a sub-directory, something like
this:
/videos/01-installation-from-script
/videos/02-daily-use-part1
/videos/02-daily-use-part2
...
2) Currently, I see that you adapt the Makefile for each video (taking
the wip-dailyUse branch as an example).
There you define the variables for the video in the Makefile:
########################## VARIABLES ###
LOCALE_LANG=en_US
NUMBER=
TARGET=videoNoCli
SESSION=
SOUNDNAME=
SLIDES=
As Ricardo pointed out around FOSDEM, it really would be better to have
the Makefile generic and then in each video's directory
a script that would set the variables and execute it.
For example:
videos/02-dailyuse-part1/make-en.sh
make -f ../Makefile LOCALE_LANG=en_US Target=videoNonCli ...
Would that make sense? Is this possible with little effort and few time left?
What help do you need, for example with the scripts/Makefiles?
Björn
I have also checked with the original project plan, and we are in quite good standing if these are done.
Topics that are still missing are these:
Config on foreign distros - this could be quite modular, and like Björn said, it could consist of showing a problem, then the resolution, then that the problem disappeared using screenshots.
Guix system configs, we could show some tricks here, but it would be much better to point to a collection of config samples, but we don't have that yet, so I would delay or skip this.
Guix system installation, as the installer is in flux, and the latest release tarball does not come with it, I would delay this.
Using the guix vm image: I remember that there are some issues here, for example there is little space. This is not guix specific, so we can skip it, maybe we should give some pointers to documentation on the website instead.
Wdyt?